From 0ce9597443956e0ffa0d152e55ff1125e773c1d4 Mon Sep 17 00:00:00 2001
From: dblock <dblock@amazon.com>
Date: Sun, 20 Oct 2024 09:41:08 -0400
Subject: [PATCH] Clarify help.

---
 public/index.html.erb               | 5 ++++-
 slack-api-explorer/commands/help.rb | 3 +++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/public/index.html.erb b/public/index.html.erb
index 6ed7138..bbbfa21 100644
--- a/public/index.html.erb
+++ b/public/index.html.erb
@@ -26,7 +26,10 @@
     <script>!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0],p=/^http:/.test(d.location)?'http':'https';if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=p+'://platform.twitter.com/widgets.js';fjs.parentNode.insertBefore(js,fjs);}}(document, 'script', 'twitter-wjs');</script>
   </p>
   <p>
-    For example, try posting a message into the <b>#general</b> channel with <pre>chat postMessage --as_user=true --text="Hello World" --channel=#general</pre>
+    For example, DM the bot.
+    <pre>auth test</pre>
+    Then invite the bot to <b>#general</b> and post a message into it via a DM.
+    <pre>chat postMessage --as_user=true --text="Hello World" --channel=#general</pre>
   </p>
   <p>
     <small>
diff --git a/slack-api-explorer/commands/help.rb b/slack-api-explorer/commands/help.rb
index 392a391..1b49e0d 100644
--- a/slack-api-explorer/commands/help.rb
+++ b/slack-api-explorer/commands/help.rb
@@ -18,6 +18,9 @@ def self.help_for(expression = nil)
         Commands
         --------
         #{`slack help`.gsub(/.*?(COMMANDS)/m, '').gsub(/^(    )/, '')}
+
+        Not sure where to start? Try "auth test", then invite the bot to #general and DM it "chat postMessage --as_user=true --text='Hello World' --channel=#general".
+
         Most commands contain subcommands, try "help <command>" (eg. "help api") to get a list of subcommands.
         ```
       EOS