Skip to content

Commit 52d969e

Browse files
committed
update docs
1 parent 7c11332 commit 52d969e

File tree

4 files changed

+18
-30
lines changed

4 files changed

+18
-30
lines changed

docs/README.md

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,7 @@ This plugin enables debugging of Temporal workflows.
1212

1313
## Quick Start
1414

15-
1. Install the plugin in GoLand.
16-
2. Configure tdlv path and debug directory in settings.
17-
3. Upload workflow history JSON in the tool window.
18-
4. Set breakpoints on events.
19-
5. Click Run to start debugging.
15+
1. Install the plugin.
16+
2. Upload workflow history JSON in the tool window.
17+
3. Set breakpoints on events.
18+
4. Click Run to start debugging.

docs/architecture.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@ The plugin consists of an IDE Debugging UI, service layer, and `tdlv` integratio
88

99
- IDE Debugging UI: Panel for history upload and set breakpoints.
1010
- IDE Debugging Service: provide api for the Debugger to retrieve the uploaded history & breakpoints.
11-
- Debugger (`tdlv`): Communicates with language debugger (think Delve, Js-Debug, Debugpy) to intercept debugging event, if a breakpoint is hit, the Debugger notifies the IDE Debugging Service to highlight the event that has its breakpoint hit.
11+
- Debugger (`tdlv`): Communicates with language debugger (think Delve, Js-Debug, Debugpy) to intercept debugging event. If a breakpoint is hit, the Debugger notifies the IDE Debugging Service to highlight the event that has its breakpoint hit.
1212
- Adapter: Adapter places sentinel breakpoints inside Temporal workflow/activity interceptors.
1313

1414

docs/developer-guide.md

Lines changed: 7 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -4,22 +4,18 @@
44

55
- Clone repository.
66
- Build custom-debugger: `go build` in custom-debugger/.
7-
- Build plugin: `./gradlew buildPlugin` in jetbrains-plugin/.
8-
7+
- Build Jetbrainsplugin: see [jetbrains plugin readme](../jetbrains-plugin/README.md)
8+
- Build vscode extension: see [vscode extension readme](../vscode-debugger-extension/README.md)
99
## Structure
1010

1111
- custom-debugger/: Intercept message from language debugger.
12-
- jetbrains-plugin/: GoLand Plugin.
13-
- replayer-adapter-go/: Inject sentinel breakpoint for Temporal Go SDK.
14-
- replayer-adapter-python/: Inject sentinel breakpoint for Temporal Python SDK.
15-
- replayer-adapter-nodejs/: Inject sentinel breakpoint for Temporal Typescript SDK.
12+
- jetbrains-plugin/: Jetbrains Plugin (support Go).
13+
- vscode-debugger-extension: Vscode Extension (support Go, Python, Js/TS).
14+
- replayer-adapter-go/: Inject sentinel breakpoints for Temporal Go SDK.
15+
- replayer-adapter-python/: Inject sentinel breakpoints for Temporal Python SDK.
16+
- replayer-adapter-nodejs/: Inject sentinel breakpoints for Temporal Typescript SDK.
1617
- example/: Test workflows.
1718

18-
## Testing
19-
20-
- Run plugin in sandbox GoLand.
21-
- Test with example workflows.
22-
2319
## Contributing
2420

2521
- Fork and branch from main.

docs/user-guide.md

Lines changed: 6 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# User Guide
22

33
## Overview
4-
There are 2 methods to use the debugger: standalone & ide integrated
4+
The major usecase of this software is via the IDE UI. There are 2 plugins supported for VSCode (support go, ts & python workflows) & Jetbrains Plugin (support go workflows)
55

66
## Tested language version
77
- Go 1.19+.
@@ -11,17 +11,10 @@ There are 2 methods to use the debugger: standalone & ide integrated
1111

1212
## Installation
1313
For both methods:
14-
1. Install tdlv from [Github Release](https://github.com/phuongdnguyen/temporal-workflow-debugger/releases).
15-
For Goland Plugin users:
16-
1. Install the plugin from [jetbrains marketplace](https://plugins.jetbrains.com/search?excludeTags=internal&products=androidstudio&products=aqua&products=clion&products=dataspell&products=dbe&products=fleet&products=go&products=idea&products=idea_ce&products=mps&products=phpstorm&products=pycharm&products=rider&products=ruby&products=rust&products=webstorm&products=writerside&search=Temporal%20workflow%20debugger)
14+
- Install tdlv from [Github Release](https://github.com/phuongdnguyen/temporal-workflow-debugger/releases).
15+
For Jetbrains Plugin users:
16+
- Install the plugin from [jetbrains marketplace](https://plugins.jetbrains.com/search?excludeTags=internal&products=androidstudio&products=aqua&products=clion&products=dataspell&products=dbe&products=fleet&products=go&products=idea&products=idea_ce&products=mps&products=phpstorm&products=pycharm&products=rider&products=ruby&products=rust&products=webstorm&products=writerside&search=Temporal%20workflow%20debugger)
17+
- Install the plugin from [vscode marketplace](https://updateme)
1718

1819
## Usage
19-
For standalone mode users:
20-
You will need a remote debugging configuration. We have examples provided in [example](../example)
21-
22-
For Goland Plugin users:
23-
1. Open tool window: View > Tool Windows > Temporal Workflow Debugger.
24-
2. Upload history: Click 'Upload Workflow History', select JSON file.
25-
3. Configure: Set debug directory and tdlv path if needed.
26-
4. Set breakpoints: Click gutter icons in history list.
27-
5. Start debug: Click 'Run'.
20+
Examples are provided in [example](../example)

0 commit comments

Comments
 (0)