Skip to content

Commit 4e4ef5b

Browse files
updates links
1 parent 91de836 commit 4e4ef5b

File tree

5 files changed

+13
-19
lines changed

5 files changed

+13
-19
lines changed

docs/english/building-an-app.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -55,7 +55,7 @@ We're going to use bot and app-level tokens for this guide.
5555

5656
:::tip[Not sharing is sometimes caring]
5757

58-
Treat your tokens like passwords and [keep them safe](/authentication/best-practices-for-security). Your app uses tokens to post and retrieve information from Slack workspaces.
58+
Treat your tokens like passwords and [keep them safe](/security). Your app uses tokens to post and retrieve information from Slack workspaces.
5959

6060
:::
6161

@@ -103,7 +103,7 @@ $ export SLACK_APP_TOKEN=<your-app-level-token>
103103

104104
:::warning[Keep it secret. Keep it safe.]
105105

106-
Remember to keep your tokens secure. At a minimum, you should avoid checking them into public version control, and access them via environment variables as we've done above. Check out the API documentation for more on [best practices for app security](/authentication/best-practices-for-security).
106+
Remember to keep your tokens secure. At a minimum, you should avoid checking them into public version control, and access them via environment variables as we've done above. Check out the API documentation for more on [best practices for app security](/security).
107107

108108
:::
109109

docs/english/getting-started.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -147,7 +147,7 @@ The above command works on Linux and macOS but [similar commands are available o
147147

148148
:::warning[Keep it secret. Keep it safe.]
149149

150-
Treat your tokens like a password and [keep it safe](/authentication/best-practices-for-security). Your app uses these to retrieve and send information to Slack.
150+
Treat your tokens like a password and [keep it safe](/security). Your app uses these to retrieve and send information to Slack.
151151

152152
:::
153153

docs/english/legacy/steps-from-apps.md

Lines changed: 3 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -68,14 +68,12 @@ app.step(ws)
6868

6969
## Adding or editing steps from apps
7070

71-
When a builder adds (or later edits) your step in their workflow, your app will receive a [`workflow_step_edit` event](/legacy/legacy-steps-from-apps/legacy-steps-from-apps-workflow_step_edit-payload). The `edit` callback in your `WorkflowStep` configuration will be run when this event is received.
71+
When a builder adds (or later edits) your step in their workflow, your app will receive a `workflow_step_edit` event. The `edit` callback in your `WorkflowStep` configuration will be run when this event is received.
7272

73-
Whether a builder is adding or editing a step, you need to send them a [step from app configuration modal](/legacy/legacy-steps-from-apps/legacy-steps-from-apps-configuration-view-object). This modal is where step-specific settings are chosen, and it has more restrictions than typical modals—most notably, it cannot include `title`, `submit`, or `close` properties. By default, the configuration modal's `callback_id` will be the same as the step from app.
73+
Whether a builder is adding or editing a step, you need to send them a step from app configuration modal. This modal is where step-specific settings are chosen, and it has more restrictions than typical modals—most notably, it cannot include `title`, `submit`, or `close` properties. By default, the configuration modal's `callback_id` will be the same as the step from app.
7474

7575
Within the `edit` callback, the `configure()` utility can be used to easily open your step's configuration modal by passing in the view's blocks with the corresponding `blocks` argument. To disable saving the configuration before certain conditions are met, you can also pass in `submit_disabled` with a value of `True`.
7676

77-
To learn more about opening configuration modals, [read the documentation](/legacy/legacy-steps-from-apps/).
78-
7977
Refer to the module documents ([common](https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html) / [step-specific](https://docs.slack.dev/tools/bolt-python/reference/workflows/step/utilities/index.html)) to learn the available arguments.
8078

8179
```python
@@ -126,8 +124,6 @@ Within the `save` callback, the `update()` method can be used to save the builde
126124
- `step_name` overrides the default Step name
127125
- `step_image_url` overrides the default Step image
128126

129-
To learn more about how to structure these parameters, [read the documentation](/legacy/legacy-steps-from-apps/).
130-
131127
Refer to the module documents ([common](https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html) / [step-specific](https://docs.slack.dev/tools/bolt-python/reference/workflows/step/utilities/index.html)) to learn the available arguments.
132128

133129
```python
@@ -167,7 +163,7 @@ app.step(ws)
167163

168164
## Executing steps from apps
169165

170-
When your step from app is executed by an end user, your app will receive a [`workflow_step_execute` event](/legacy/legacy-steps-from-apps/legacy-steps-from-apps-workflow_step-object). The `execute` callback in your `WorkflowStep` configuration will be run when this event is received.
166+
When your step from app is executed by an end user, your app will receive a `workflow_step_execute` event. The `execute` callback in your `WorkflowStep` configuration will be run when this event is received.
171167

172168
Using the `inputs` from the `save` callback, this is where you can make third-party API calls, save information to a database, update the user's Home tab, or decide the outputs that will be available to subsequent steps from apps by mapping values to the `outputs` object.
173169

docs/japanese/getting-started.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -48,7 +48,7 @@ Slack アプリで使用できるトークンには、ユーザートークン
4848

4949
6. 左サイドメニューの「**Socket Mode**」を有効にします。
5050

51-
:::tip[トークンはパスワードと同様に取り扱い、[安全な方法で保管してください](/authentication/best-practices-for-security)。アプリはこのトークンを使って Slack ワークスペースで投稿をしたり、情報の取得をしたりします。]
51+
:::tip[トークンはパスワードと同様に取り扱い、[安全な方法で保管してください](/security)。アプリはこのトークンを使って Slack ワークスペースで投稿をしたり、情報の取得をしたりします。]
5252

5353
:::
5454

@@ -91,7 +91,7 @@ export SLACK_APP_TOKEN=<アプリレベルトークン>
9191
```
9292
:::warning[🔒 全てのトークンは安全に保管してください。]
9393

94-
少なくともパブリックなバージョン管理にチェックインするようなことは避けるべきでしょう。また、上にあった例のように環境変数を介してアクセスするようにしてください。詳細な情報は [アプリのセキュリティのベストプラクティス](/authentication/best-practices-for-security)のドキュメントを参照してください。
94+
少なくともパブリックなバージョン管理にチェックインするようなことは避けるべきでしょう。また、上にあった例のように環境変数を介してアクセスするようにしてください。詳細な情報は [アプリのセキュリティのベストプラクティス](/security)のドキュメントを参照してください。
9595

9696
:::
9797

docs/japanese/legacy/steps-from-apps.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -10,8 +10,6 @@
1010

1111
ワークフローステップを機能させるためには、これら 3 つのイベントすべてに対応する必要があります。
1212

13-
アプリを使ったワークフローステップに関する詳細は、[API ドキュメント](/legacy/legacy-steps-from-apps/)を参照してください。
14-
1513
## ステップの定義
1614

1715
ワークフローステップの作成には、Bolt が提供する `WorkflowStep` クラスを利用します。
@@ -59,13 +57,13 @@ app.step(ws)
5957

6058
## ステップの追加・編集
6159

62-
作成したワークフローステップがワークフローに追加またはその設定を変更されるタイミングで、[`workflow_step_edit` イベントがアプリに送信されます](/legacy/legacy-steps-from-apps/legacy-steps-from-apps-workflow_step_edit-payload)。このイベントがアプリに届くと、`WorkflowStep` で設定した `edit` コールバックが実行されます。
60+
作成したワークフローステップがワークフローに追加またはその設定を変更されるタイミングで、`workflow_step_edit` イベントがアプリに送信されます。このイベントがアプリに届くと、`WorkflowStep` で設定した `edit` コールバックが実行されます。
6361

64-
ステップの追加と編集のどちらが行われるときも、[ワークフローステップの設定モーダル](/legacy/legacy-steps-from-apps/legacy-steps-from-apps-configuration-view-object)をビルダーに送信する必要があります。このモーダルは、そのステップ独自の設定を選択するための場所です。通常のモーダルより制限が強く、例えば `title``submit``close` のプロパティを含めることができません。設定モーダルの `callback_id` は、デフォルトではワークフローステップと同じものになります。
62+
ステップの追加と編集のどちらが行われるときも、ワークフローステップの設定モーダルをビルダーに送信する必要があります。このモーダルは、そのステップ独自の設定を選択するための場所です。通常のモーダルより制限が強く、例えば `title``submit``close` のプロパティを含めることができません。設定モーダルの `callback_id` は、デフォルトではワークフローステップと同じものになります。
6563

6664
`edit` コールバック内で `configure()` ユーティリティを使用すると、対応する `blocks` 引数にビューのblocks 部分だけを渡して、ステップの設定モーダルを簡単に表示させることができます。必要な入力内容が揃うまで設定の保存を無効にするには、`True` の値をセットした `submit_disabled` を渡します。
6765

68-
設定モーダルの開き方に関する詳細は、[こちらのドキュメント](/legacy/legacy-steps-from-apps/legacy-steps-from-apps-configuration-view-object)を参照してください
66+
設定モーダルの開き方に関する詳細は、こちらのドキュメントを参照してください
6967

7068
指定可能な引数の一覧はモジュールドキュメントを参考にしてください(<a href="https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html">共通</a> / <a href="https://docs.slack.dev/tools/bolt-python/reference/workflows/step/utilities/index.html">ステップ用</a>
7169

@@ -117,7 +115,7 @@ app.step(ws)
117115
- `step_name` : ステップのデフォルトの名前をオーバーライドします。
118116
- `step_image_url` : ステップのデフォルトの画像をオーバーライドします。
119117

120-
これらのパラメータの構成方法に関する詳細は、[こちらのドキュメント](/legacy/legacy-steps-from-apps/legacy-steps-from-apps-workflow_step-object)を参照してください
118+
これらのパラメータの構成方法に関する詳細は、こちらのドキュメントを参照してください
121119

122120
指定可能な引数の一覧はモジュールドキュメントを参考にしてください(<a href="https://docs.slack.dev/tools/bolt-python/reference/kwargs_injection/args.html">共通</a> / <a href="https://docs.slack.dev/tools/bolt-python/reference/workflows/step/utilities/index.html">ステップ用</a>
123121

@@ -158,7 +156,7 @@ app.step(ws)
158156

159157
## ステップの実行
160158

161-
エンドユーザーがワークフローステップを実行すると、アプリに [`workflow_step_execute` イベントが送信されます](/legacy/legacy-steps-from-apps/legacy-steps-from-apps-workflow_step-object)。このイベントがアプリに届くと、`WorkflowStep` で設定した `execute` コールバックが実行されます。
159+
エンドユーザーがワークフローステップを実行すると、アプリに `workflow_step_execute` イベントが送信されます。このイベントがアプリに届くと、`WorkflowStep` で設定した `execute` コールバックが実行されます。
162160

163161
`save` コールバックで取り出した `inputs` を使って、サードパーティの API を呼び出す、情報をデータベースに保存する、ユーザーのホームタブを更新するといった処理を実行することができます。また、ワークフローの後続のステップで利用する出力値を `outputs` オブジェクトに設定します。
164162

0 commit comments

Comments
 (0)