Fix #358 Add more links to listener argument guide in document pages (#360)

Author: seratch

docs/_advanced/global_middleware.md

@@ -11,6 +11,8 @@ Global middleware is run for all incoming events, before any listener middleware
 Both global and listener middleware must call `next()` to pass control of the execution chain to the next middleware. 
 </div>
 
+<div>
+<span class="annotation">Refer to <a href="https://slack.dev/bolt-python/api-docs/slack_bolt/kwargs_injection/args.html" target="_blank">the module document</a> to learn the available listener arguments.</span>
 ```python
 @app.use
 def auth_acme(client, context, logger, payload, next):
@@ -32,3 +34,4 @@ def auth_acme(client, context, logger, payload, next):
     # Pass control to the next middleware
     next()
 ```
+</div>

docs/_advanced/ja_global_middleware.md

@@ -11,6 +11,8 @@ order: 6
 グローバルミドルウェアでもリスナーミドルウェアでも、次のミドルウェアに実行チェーンの制御をリレーするために、`next()` を呼び出す必要があります。 
 </div>
 
+<div>
+<span class="annotation">指定可能な引数の一覧は<a href="https://slack.dev/bolt-python/api-docs/slack_bolt/kwargs_injection/args.html" target="_blank">モジュールドキュメント</a>を参考にしてください。</span>
 ```python
 @app.use
 def auth_abc(client, context, logger, payload, next):
@@ -32,3 +34,4 @@ def auth_abc(client, context, logger, payload, next):
     # 次のミドルウェアに実行権を渡します
     next()
 ```
+</div>

docs/_advanced/ja_listener_middleware.md

@@ -9,6 +9,8 @@ order: 5
 リスナーミドルウェアは、それを渡したリスナーでのみ実行されるミドルウェアです。リスナーには、`middleware` パラメーターを使ってミドルウェア関数をいくつでも渡すことができます。このパラメーターには、1 つまたは複数のミドルウェア関数からなるリストを指定します。
 </div>
 
+<div>
+<span class="annotation">指定可能な引数の一覧は<a href="https://slack.dev/bolt-python/api-docs/slack_bolt/kwargs_injection/args.html" target="_blank">モジュールドキュメント</a>を参考にしてください。</span>
 ```python
 # "bot_message" サブタイプのメッセージを抽出するリスナーミドルウェア
 def no_bot_messages(message, next):
@@ -22,3 +24,4 @@ def log_message(logger, event):
     logger.info(f"(MSG) User: {event['user']}
 Message: {event['text']}")
 ```
+</div>

docs/_advanced/listener_middleware.md

@@ -9,6 +9,8 @@ order: 5
 Listener middleware is only run for the listener in which it's passed. You can pass any number of middleware functions to the listener using the `middleware` parameter, which must be a list that contains one to many middleware functions.
 </div>
 
+<div>
+<span class="annotation">Refer to <a href="https://slack.dev/bolt-python/api-docs/slack_bolt/kwargs_injection/args.html" target="_blank">the module document</a> to learn the available listener arguments.</span>
 ```python
 # Listener middleware which filters out messages with "bot_message" subtype
 def no_bot_messages(message, next):
@@ -21,3 +23,4 @@ def no_bot_messages(message, next):
 def log_message(logger, event):
     logger.info(f"(MSG) User: {event['user']}\nMessage: {event['text']}")
 ```
+</div>

docs/_basic/acknowledging_events.md

@@ -15,6 +15,8 @@ We recommend calling `ack()` right away before sending a new message or fetching
 
 </div>
 
+<div>
+<span class="annotation">Refer to <a href="https://slack.dev/bolt-python/api-docs/slack_bolt/kwargs_injection/args.html" target="_blank">the module document</a> to learn the available listener arguments.</span>
 ```python
 # Example of responding to an external_select options request
 @app.options("menu_selection")
@@ -31,3 +33,4 @@ def show_menu_options(ack):
     ]
     ack(options=options)
 ```
+</div>

docs/_basic/ja_acknowledging_events.md

@@ -15,6 +15,8 @@ order: 7
 
 </div>
 
+<div>
+<span class="annotation">指定可能な引数の一覧は<a href="https://slack.dev/bolt-python/api-docs/slack_bolt/kwargs_injection/args.html" target="_blank">モジュールドキュメント</a>を参考にしてください。</span>
 ```python
 # 外部データを使用する選択メニューオプションに応答するサンプル
 @app.options("menu_selection")
@@ -31,3 +33,4 @@ def show_menu_options(ack):
     ]
     ack(options=options)
 ```
+</div>

docs/_basic/ja_listening_actions.md

@@ -14,13 +14,16 @@ Bolt アプリは `action` メソッドを用いて、ボタンのクリック
 
 </div>
 
+<div>
+<span class="annotation">指定可能な引数の一覧は<a href="https://slack.dev/bolt-python/api-docs/slack_bolt/kwargs_injection/args.html" target="_blank">モジュールドキュメント</a>を参考にしてください。</span>
 ```python
 # 'approve_button' という action_id のブロックエレメントがトリガーされるたびに、このリスナーが呼び出させれる
 @app.action("approve_button")
 def update_message(ack):
     ack()
     # アクションへの反応としてメッセージを更新
 ```
+</div>
 
 <details class="secondary-wrapper">
 <summary class="section-head" markdown="0">

docs/_basic/ja_listening_events.md

@@ -13,6 +13,8 @@ order: 3
 
 </div>
 
+<div>
+<span class="annotation">指定可能な引数の一覧は<a href="https://slack.dev/bolt-python/api-docs/slack_bolt/kwargs_injection/args.html" target="_blank">モジュールドキュメント</a>を参考にしてください。</span>
 ```python
 # ユーザーがワークスペースに参加した際に、自己紹介を促すメッセージを指定のチャンネルに送信
 @app.event("team_join")
@@ -22,6 +24,7 @@ def ask_for_introduction(event, say):
     text = f"Welcome to the team, <@{user_id}>! 🎉 You can introduce yourself in this channel."
     say(text=text, channel=welcome_channel_id)
 ```
+</div>
 
 <details class="secondary-wrapper" >
 

docs/_basic/ja_listening_messages.md

@@ -10,16 +10,18 @@ order: 1
 [あなたのアプリがアクセス権限を持つ](https://api.slack.com/messaging/retrieving#permissions)メッセージの投稿イベントをリッスンするには `message()` メソッドを利用します。このメソッドは `type` が `message` ではないイベントを処理対象から除外します。
 
 `message()` の引数には `str` 型または `re.Pattern` オブジェクトを指定できます。この条件のパターンに一致しないメッセージは除外されます。
-
 </div>
 
+<div>
+<span class="annotation">指定可能な引数の一覧は<a href="https://slack.dev/bolt-python/api-docs/slack_bolt/kwargs_injection/args.html" target="_blank">モジュールドキュメント</a>を参考にしてください。</span>
 ```python
 # '👋' が含まれるすべてのメッセージに一致
 @app.message(":wave:")
 def say_hello(message, say):
     user = message['user']
     say(f"Hi there, <@{user}>!")
 ```
+</div>
 
 <details class="secondary-wrapper">
 <summary markdown="0">

docs/_basic/ja_listening_modals.md

@@ -15,6 +15,8 @@ order: 12
 
 </div>
 
+<div>
+<span class="annotation">指定可能な引数の一覧は<a href="https://slack.dev/bolt-python/api-docs/slack_bolt/kwargs_injection/args.html" target="_blank">モジュールドキュメント</a>を参考にしてください。</span>
 ```python
 # view_submission イベントを処理
 @app.view("view_1")
@@ -46,3 +48,4 @@ def handle_submission(ack, body, client, view):
         # ユーザーにメッセージを送信
         client.chat_postMessage(channel=user, text=msg)
 ```
+</div>