Merge pull request #402 from seratch/shortcuts-docs

Add shortcuts docs

Author: seratch

docs/_includes/sidebar-ja.md

@@ -24,11 +24,9 @@
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/ja/getting-started-with-bolt">Bolt️ ことはじめ</a></li>
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/ja/bolt-basics">Bolt️ の概要</a></li>
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/ja/slash-commands">スラッシュコマンド</a></li>
-      <!--
-      <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/ja/actions">アクション</a></li>
-      -->
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/ja/interactive-components">インタラクティブコンポーネント</a></li>
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/ja/modals">モーダル</a></li>
+      <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/ja/shortcuts">ショートカット</a></li>
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/ja/app-home">Home タブ</a></li>
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/ja/events-api">イベント API</a></li>
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/ja/app-distribution">アプリの配布 (OAuth)</a></li>

docs/_includes/sidebar.md

@@ -24,11 +24,9 @@
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/getting-started-with-bolt">Getting Started</a></li>
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/bolt-basics">Bolt Basics</a></li>
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/slash-commands">Slash Commands</a></li>
-      <!--
-      <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/actions">Actions</a></li>
-      -->
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/interactive-components">Interactive Components</a></li>
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/modals">Modals</a></li>
+      <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/shortcuts">Shortcuts</a></li>
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/app-home">App Home</a></li>
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/events-api">Events API</a></li>
       <li class="toctree-l2"><a href="{{ site.url | append: site.baseurl }}/guides/app-distribution">App Distribution (OAuth)</a></li>

docs/assets/images/bolt-actions.png

@@ -34,24 +34,25 @@ Here is the list of the available methods to dispatch events.
 |**app.event**|event type: **Class\<Event\>**|[**Events API**]({{ site.url | append: site.baseurl }}/guides/events-api): Responds to any kinds of bot/user events you subscribe.|
 |**app.message**|keyword: **String** \| **Pattern**|[**Events API**]({{ site.url | append: site.baseurl }}/guides/events-api): Responds to messages posted by a user only when the text in messages matches the given keyword or regular expressions.|
 |**app.command**|command name: **String** \| **Pattern**|[**Slash Commands**]({{ site.url | append: site.baseurl }}/guides/slash-commands): Responds to slash command invocations in the workspace.|
-|**app.messageAction**|callback_id: **String** \| **Pattern**|[**Actions**]({{ site.url | append: site.baseurl }}/guides/actions): Responds to user actions in message menus.|
 |**app.blockAction**|action_id: **String** \| **Pattern**|[**Interactive Components**]({{ site.url | append: site.baseurl }}/guides/interactive-components): Responds to user actions (e.g., click a button, choose an item from select menus, radio buttons, etc.) in **blocks**. These events can be triggered in all the surfaces (messages, modals, and Home tabs).|
 |**app.blockSuggestion**|action_id: **String** \| **Pattern**|[**Interactive Components**]({{ site.url | append: site.baseurl }}/guides/interactive-components): Responds to user actions to input a keyword (the length needs to be the `min_query_length` or longer) in select menus (external data source).|
 |**app.viewSubmission**|callback_id: **String** \| **Pattern**|[**Modals**]({{ site.url | append: site.baseurl }}/guides/modals): Responds to data submissions in modals.|
 |**app.viewClosed**|callback_id: **String** \| **Pattern**|[**Modals**]({{ site.url | append: site.baseurl }}/guides/modals): Responds to the events where users close modals by clicking Cancel buttons. The `notify_on_close` has to be `true` when opening/pushing the modal.|
+|**app.globalShortcut**|callback_id: **String** \| **Pattern**|[**Shortcuts**]({{ site.url | append: site.baseurl }}/guides/shortcuts): Responds to global shortcut invocations.|
+|**app.messageShortcut**|callback_id: **String** \| **Pattern**|[**Shortcuts**]({{ site.url | append: site.baseurl }}/guides/shortcuts): Responds to shortcut invocations in message menus.|
 |**app.dialogSubmission**|callback_id: **String** \| **Pattern**|**Dialogs**: Responds to data submissions in dialogs.|
 |**app.dialogSuggestion**|callback_id: **String** \| **Pattern**|**Dialogs**: Responds to requests to load options for `"external"` typed select menus in dialogs.|
 |**app.dialogCancellation**|callback_id **String** \| **Pattern**|**Dialogs**: Responds to the events where users close dialogs by clicking Cancel buttons.|
-|**app.attachmentAction**|callback_id: **String** \| **Pattern**|**Legacy Messaging**: Responds to user actions in **attachements**. These events can be triggered in only messages.|
+|**app.attachmentAction**|callback_id: **String** \| **Pattern**|**Legacy Messaging**: Responds to user actions in **attachments**. These events can be triggered in only messages.|
 
 ## Development Guides by Feature
 
 On these guide pages, you'll find a more concrete example code for each.
 
 * [**Slash Commands**]({{ site.url | append: site.baseurl }}/guides/slash-commands)
-* [**Actions**]({{ site.url | append: site.baseurl }}/guides/actions)
 * [**Interactive Components**]({{ site.url | append: site.baseurl }}/guides/interactive-components)
 * [**Modals**]({{ site.url | append: site.baseurl }}/guides/modals)
+* [**Shortcuts**]({{ site.url | append: site.baseurl }}/guides/shortcuts)
 * [**App Home**]({{ site.url | append: site.baseurl }}/guides/app-home)
 * [**Events API**]({{ site.url | append: site.baseurl }}/guides/events-api)
 * [**App Distribution (OAuth Flow)**]({{ site.url | append: site.baseurl }}/guides/app-distribution)

docs/guides/bolt-basics.md

@@ -34,11 +34,12 @@ app.command("/echo", (req, ctx) -> {
 |**app.event**|イベントデータ型: **Class\<Event\>**|[**イベント API**]({{ site.url | append: site.baseurl }}/guides/ja/events-api): 購読しているあらゆる bot/user events に応答します。|
 |**app.message**|キーワード: **String** \| **Pattern**|[**イベント API**]({{ site.url | append: site.baseurl }}/guides/ja/events-api): ユーザーからのメッセージ投稿で指定のキーワード・正規表現にマッチする bot/user events に応答します。|
 |**app.command**|コマンド名: **String** \| **Pattern**|[**スラッシュコマンド**]({{ site.url | append: site.baseurl }}/guides/ja/slash-commands): スラッシュコマンドの実行に応答します。|
-|**app.messageAction**|callback_id: **String** \| **Pattern**|[**アクション**]({{ site.url | append: site.baseurl }}/guides/ja/actions): メッセージメニューのアクション実行に応答します。|
 |**app.blockAction**|action_id: **String** \| **Pattern**|[**インタラクティブコンポーネント**]({{ site.url | append: site.baseurl }}/guides/ja/interactive-components): **blocks** 内でのボタンクリック、セレクトメニューからの選択、ラジオボタン選択などユーザクアションに応答します。これらのイベントは全てのサーフェスエリア（メッセージ、モーダル、Home タブ）で発火します。|
 |**app.blockSuggestion**|action_id: **String** \| **Pattern**|[**インタラクティブコンポーネント**]({{ site.url | append: site.baseurl }}/guides/ja/interactive-components): **blocks** 内の external data source を使ったセレクトメニュー内でユーザーが `min_query_length` 以上の長さのキーワードを入力したときに表示する選択肢を応答します。|
 |**app.viewSubmission**|callback_id: **String** \| **Pattern**|[**モーダル**]({{ site.url | append: site.baseurl }}/guides/ja/modals): Submit ボタンクリックによるデータ送信に応答します。|
 |**app.viewClosed**|callback_id: **String** \| **Pattern**|[**モーダル**]({{ site.url | append: site.baseurl }}/guides/ja/modals): ユーザーがモーダルを閉じたときのイベントに応答します。そのモーダルを open/push したときに `notify_on_close` が `true` に設定されている必要があります。|
+|**app.globalShortcut**|callback_id: **String** \| **Pattern**|[**ショートカット**]({{ site.url | append: site.baseurl }}/guides/ja/shortcuts): ショートカット実行に応答します。|
+|**app.messageShortcut**|callback_id: **String** \| **Pattern**|[**ショートカット**]({{ site.url | append: site.baseurl }}/guides/ja/shortcuts): メッセージメニューのショートカット実行に応答します。|
 |**app.dialogSubmission**|callback_id: **String** \| **Pattern**|**ダイアログ**: ダイアログでのデータ送信に応答します。|
 |**app.dialogSuggestion**|callback_id: **String** \| **Pattern**|**ダイアログ**: ダイアログ内での `"external"` type に設定されたセレクトメニューの選択肢読み込みのリクエストに応答します。|
 |**app.dialogCancellation**|callback_id **String** \| **Pattern**|**ダイアログ**: ダイアログが閉じたときのイベントに応答します。|
@@ -49,9 +50,9 @@ app.command("/echo", (req, ctx) -> {
 以下のガイドページで、それぞれの機能について具体的なコード例を見つけることができます。
 
 * [**スラッシュコマンド**]({{ site.url | append: site.baseurl }}/guides/ja/slash-commands)
-* [**アクション**]({{ site.url | append: site.baseurl }}/guides/ja/actions)
 * [**インタラクティブコンポーネント**]({{ site.url | append: site.baseurl }}/guides/ja/interactive-components)
 * [**モーダル**]({{ site.url | append: site.baseurl }}/guides/ja/modals)
+* [**ショートカット**]({{ site.url | append: site.baseurl }}/guides/ja/shortcuts)
 * [**Home タブ**]({{ site.url | append: site.baseurl }}/guides/ja/app-home)
 * [**イベント API**]({{ site.url | append: site.baseurl }}/guides/ja/events-api)
 * [**アプリの配布 (OAuth Flow)**]({{ site.url | append: site.baseurl }}/guides/ja/app-distribution)