Update the respond utility guide (slackapi#538)

seratch · srajiang · web-flow · commit 92c3380c1c19 · 2021-12-08T00:22:57.000+09:00
Co-authored-by: Sarah Jiang &lt;srajiang@gmail.com&gt;
diff --git a/docs/.gitignore b/docs/.gitignore
@@ -5,3 +5,4 @@ Gemfile.lock
 .vscode/
 .bundle/
 vendor/
+.ruby-version
diff --git a/docs/_basic/ja_responding_actions.md b/docs/_basic/ja_responding_actions.md
@@ -31,7 +31,7 @@ def approve_request(ack, say):
 
 <div class="secondary-content" markdown="0">
 
-`respond()` は `response_url` を使って送信するときに便利なメソッドで、これらと同じような動作をします。投稿するメッセージのペイロードには JSON オブジェクトを渡すことができ、メッセージはやり取りの発生元に反映されます。オプションのプロパティとして `response_type`（値は `in_channel` または `ephemeral`）、`replace_original`、`delete_original` などを指定できます。
+`respond()` は `response_url` を使って送信するときに便利なメソッドで、これらと同じような動作をします。投稿するメッセージのペイロードには、全ての[メッセージペイロードのプロパティ](https://api.slack.com/reference/messaging/payload)とオプションのプロパティとして `response_type`（値は `"in_channel"` または `"ephemeral"`）、`replace_original`、`delete_original`、`unfurl_links`、`unfurl_media` などを指定できます。こうすることによってアプリから送信されるメッセージは、やり取りの発生元に反映されます。
 
 </div>
 
diff --git a/docs/_basic/responding_actions.md b/docs/_basic/responding_actions.md
@@ -32,7 +32,7 @@ def approve_request(ack, say):
 
 <div class="secondary-content" markdown="0">
 
-Since `respond()` is a utility for calling the `response_url`, it behaves in the same way. You can pass a JSON object with a new message payload that will be published back to the source of the original interaction with optional properties like `response_type` (which has a value of `in_channel` or `ephemeral`), `replace_original`, and `delete_original`.
+Since `respond()` is a utility for calling the `response_url`, it behaves in the same way. You can pass [all the message payload properties](https://api.slack.com/reference/messaging/payload) as keyword arguments along with optional properties like `response_type` (which has a value of `"in_channel"` or `"ephemeral"`), `replace_original`, `delete_original`, `unfurl_links`, and `unfurl_media`. With that, your app can send a new message payload that will be published back to the source of the original interaction.
 
 </div>
 
