docs: fix trello/trello-github-integ plugin doc issues

Author: IronCore864

docs/plugins/trello-github-integ_plugin.md

@@ -4,11 +4,22 @@ This plugin creates a new GitHub Actions workflow(trello-github-integration) and
 
 ## 2 Usage:
 
-_This plugin depends on the plugin `trello`:_
+This plugin depends on and can be used together with the `trello` plugin (see document [here](./trello_plugin.md)).
+
+`trello-github-integ` plugin can also use `trello` plugin's outputs as input. See the example below:
 
 ```yaml
 tools:
-- name: trello-github-integ-default
+- name: my-trello-board
+  plugin:
+    kind: trello
+    version: 0.2.0
+  dependsOn: ["demo.github-repo-scaffolding-golang"]
+  options:
+    owner: YOUR_GITHUB_USERNAME
+    repo: YOUR_REPO_NAME
+    kanbanBoardName: KANBAN_BOARD_NAME
+- name: trello-github
   # plugin profile
   plugin:
     # kind of this plugin
@@ -17,58 +28,31 @@ tools:
     # checkout the version from the GitHub releases
     version: 0.2.0
   # optional; if specified, dtm will make sure the dependency is applied first before handling this tool.
-  dependsOn: [ "TRELLO_INSTANCE_NAME.trello" ]
+  dependsOn: [ "my-trello-board.trello" ]
   # options for the plugin
   options:
     # the repo's owner. It should be case-sensitive here; strictly use your GitHub user name; please change the value below.
     owner: YOUR_GITHUB_USERNAME
     # the repo where you'd like to setup GitHub Actions; please change the value below.
     repo: YOUR_REPO_NAME
     # reference parameters come from dependency, their usage will be explained later
-    boardId: ${{ TRELLO_INSTANCE_NAME.trello.outputs.boardId }}
-    todoListId: ${{ TRELLO_INSTANCE_NAME.trello.outputs.todoListId }}
-    doingListId: ${{ TRELLO_INSTANCE_NAME.trello.outputs.doingListId }}
-    doneListId: ${{ TRELLO_INSTANCE_NAME.trello.outputs.doneListId }}
+    boardId: ${{ my-trello-board.trello.outputs.boardId }}
+    todoListId: ${{ my-trello-board.trello.outputs.todoListId }}
+    doingListId: ${{ my-trello-board.trello.outputs.doingListId }}
+    doneListId: ${{ my-trello-board.trello.outputs.doneListId }}
     # main branch of the repo (to which branch the plugin will submit the workflows)
     branch: main
 ```
 
-## 3. Use Together with the `trello` Plugin
+Replace the following from the config above:
 
-This plugin can be used together with the `trello` plugin (see document [here](./trello_plugin.md).)
-
-See the example below:
-
-```yaml
----
-tools:
-  - name: trello_init_demo
-    plugin:
-      kind: trello
-      version: 0.2.0
-    options:
-      owner: lfbdev
-      repo: golang-demo
-      kanbanBoardName: kanban-name
-  - name: trello_github_integ_demo
-    plugin:
-      kind: trello-github-integ
-      version: 0.2.0
-    dependsOn: ["trello_init_demo.trello"]
-    options:
-      owner: lfbdev
-      repo: golang-demo
-      boardId: ${{ trello_init_demo.trello.outputs.boardId }}
-      todoListId: ${{ trello_init_demo.trello.outputs.todoListId }}
-      doingListId: ${{ trello_init_demo.trello.outputs.doingListId }}
-      doneListId: ${{ trello_init_demo.trello.outputs.doneListId }}
-      branch: main
-```
+- `YOUR_GITHUB_USERNAME`
+- `YOUR_REPO_NAME`
+- `KANBAN_BOARD_NAME`
 
 In the example above:
 
-- We put `trello_init_demo.trello` as a dependency by using the `dependsOn` keyword.
-- We use `trello_init_demo.trello`'s output as input for the `trello_github_integ_demo` plugin.
+- We create a Trello board using `trello` plugin, and the board is marked to be used for repo YOUR_GITHUB_USERNAME/YOUR_REPO_NAME.
+- `trello-github-integ` plugin depends on `trello` plugin, because we use `trello` plugin's outputs as the input for the `trello-github-integ` plugin.
 
 Pay attention to the `${{ xxx }}` part in the example. `${{ TOOL_NAME.TOOL_KIND.outputs.var}}` is the syntax for using an output.
-

docs/plugins/trello_plugin.md

@@ -18,58 +18,36 @@ To create a Trello API key and token, see [here](https://trello.com/app-key).
 
 ```yaml
 tools:
-  - name: default
-    # plugin profile
-    plugin:
-      # kind of this plugin
-      kind: trello
-      # version of the plugin
-      version: 0.2.0
-    # options for the plugin, checkout the version from the GitHub releases
-    options:
-      # the repo's owner (if kanbanBoardName is empty, use owner/repo as the boardname)
-      owner: lfbdev
-      # the repo name  (if kanbanBoardName is empty, use owner/repo as the boardname)
-      repo: golang-demo
-      # the Tello board name 
-      kanbanBoardName: kanban-name
+- name: my-trello-board
+  # plugin profile
+  plugin:
+    # kind of this plugin
+    kind: trello
+    # version of the plugin
+    version: 0.2.0
+  # options for the plugin, checkout the version from the GitHub releases
+  options:
+    # the repo's owner
+    owner: YOUR_GITHUB_USERNAME
+    # for which repo this board will be used
+    repo: YOUR_REPO_NAME
+    # the Tello board name. If empty, use owner/repo as the board's name.
+    kanbanBoardName: KANBAN_BOARD_NAME
 ```
 
-## 3. Use Together with the `trello-github-integ` Plugin
+Replace the following from the config above:
 
-This plugin can be used together with the `trello-github-integ` plugin (see document [here](./trello-github-integ_plugin.md).)
+- `YOUR_GITHUB_USERNAME`
+- `YOUR_REPO_NAME`
+- `KANBAN_BOARD_NAME`
 
-See the example below:
+## 3. Outputs
 
-```yaml
----
-tools:
-  - name: trello_init_demo
-    plugin:
-      kind: trello
-      version: 0.2.0
-    options:
-      owner: lfbdev
-      repo: golang-demo
-      kanbanBoardName: kanban-name
-  - name: trello_github_integ_demo
-    plugin:
-      kind: trello-github-integ
-      version: 0.2.0
-    dependsOn: ["trello_init_demo.trello"]
-    options:
-      owner: lfbdev
-      repo: golang-demo
-      boardId: ${{ trello_init_demo.trello.outputs.boardId }}
-      todoListId: ${{ trello_init_demo.trello.outputs.todoListId }}
-      doingListId: ${{ trello_init_demo.trello.outputs.doingListId }}
-      doneListId: ${{ trello_init_demo.trello.outputs.doneListId }}
-      branch: main
-```
-
-In the example above:
+This plugin has four outputs:
 
-- We put `default.trello` as a dependency by using the `dependsOn` keyword.
-- We use `default.trello`'s output as input for the `default_trello_github` plugin.
+- `boardId`
+- `todoListId`
+- `doingListId`
+- `doneListId`
 
-Pay attention to the `${{ xxx }}` part in the example. `${{ TOOL_NAME.TOOL_KIND.outputs.var}}` is the syntax for using an output.
+which can be used by the `trello-github-integ` plugin. Refer to the [`trello-github-integ` plugin doc](./trello-github-integ_plugin.md) for more details.