From 77e13626afeb4fcd0888144a0ddd3999aa58a7a3 Mon Sep 17 00:00:00 2001
From: Dragory <2606411+Dragory@users.noreply.github.com>
Date: Mon, 25 May 2020 23:55:50 +0300
Subject: [PATCH] docs: add Snippets page, clean up Commands page

---
 README.md         |   1 +
 docs/commands.md  | 136 +++++++++++++++++++++++++++++++++++++---------
 docs/snippets.gif | Bin 0 -> 13470 bytes
 docs/snippets.md  |  53 ++++++++++++++++++
 4 files changed, 164 insertions(+), 26 deletions(-)
 create mode 100644 docs/snippets.gif
 create mode 100644 docs/snippets.md

diff --git a/README.md b/README.md
index 4863c7f..af4e399 100644
--- a/README.md
+++ b/README.md
@@ -10,6 +10,7 @@ Inspired by Reddit's modmail system.
 * **[🛠️ Setting up the bot](docs/setup.md)**
 * [📝 Configuration](docs/configuration.md)
 * [🤖 Commands](docs/commands.md)
+* [📋 Snippets](docs/snippets.md)
 * [🧩 Plugins](docs/plugins.md)
 * [🙋 Frequently Asked Questions](docs/faq.md)
 * [Release notes](CHANGELOG.md)
diff --git a/docs/commands.md b/docs/commands.md
index 397cf16..8e8f863 100644
--- a/docs/commands.md
+++ b/docs/commands.md
@@ -1,31 +1,115 @@
 # 🤖 Commands
 
+## Table of contents
+* [Inside a ModMail thread](#inside-a-modmail-thread)
+* [Anywhere on the inbox server](#anywhere-on-the-inbox-server)
+* [Snippets (canned messages)](#snippets-canned-messages)
+
+## Inside a ModMail thread
+These commands can only be used inside a ModMail thread's channel on the inbox server.
+
+### `!reply <text>` / `!r <text>`
+Send a reply to the user.
+
+**Example:** `!r How can I help you?`
+
+To reply automatically without using `!reply`, [enable `alwaysReply` in bot settings](configuration.md).
+
+### `!anonreply <text>` / `!ar <text>`
+Send an anonymous reply to the user. Anonymous replies only show the moderator's role in the reply.
+
+**Example:** `!ar Please only use ModMail for serious messages`
+
+### `!close`
+Close the ModMail thread.
+
+### `!close <time>`
+Close the ModMail thread after a timer. Sending a message to the user or receiving a message from the user will cancel scheduled closing.
+
+**Example:** `!close 15m`
+
+### `!close cancel`
+Cancel a timed close.
+
+### `!logs`
+List previous ModMail logs with the user.
+
+### `!block`
+Block the user from using ModMail.
+
+### `!block <time>`
+Block the user from using ModMail for a specified time.
+
+**Example:** `!block 7d`
+
+### `!unblock`
+Unblock the user, allowing them to use ModMail again.
+
+### `!move <category>`
+Move the ModMail thread to a different category.
+Requires `allowMove` to be enabled in the bot's settings.
+
+### `!suspend`
+Suspend the thread.
+The thread will act as closed and will not receive any messages until unsuspended via `!unsuspend`.
+
+### `!unsuspend`
+Unsuspend the thread. See `!suspend` above.
+
+### `!alert`
+Pings you when the thread gets a new reply.
+
+### `!alert cancel`
+Cancel the ping set by `!alert`.
+
+### `!loglink`
+Get a link to the open ModMail thread's log.
+
+### `!loglink -s`
+Get a link to the open ModMail thread's log, only showing messages to/from the user (ignores mod chatter within the thread).
+
+### `!loglink -v`
+Get a link to the open ModMail thread's log, showing extra details about channel and message IDs between the bot and the user.
+This is mainly useful when reporting messages to Discord's Trust & Safety team.
+
+### `!id`
+Prints the user's ID.
+
 ## Anywhere on the inbox server
-`!logs <user> <page>` Lists previous modmail logs with the specified user. If there are a lot of logs, they will be paginated. In this case, you can specify the page number to view as the second argument.  
-`!block <user> <time>` Blocks the specified user from using modmail. If a time is specified, the block is temporary.  
-`!unblock <user> <time>` Unblocks the specified user from using modmail. If a time is specified, the user will be scheduled to be unblocked after that time.  
-`!is_blocked <user>` Checks whether the user is blocked and for how long  
-`!s <shortcut> <text>` Adds a snippet (a canned response). Supports {1}, {2}, etc. for arguments. See below for how to use it.  
-`!edit_snippet <shortcut> <text>` Edits an existing snippet (alias `!es`)  
-`!delete_snippet <shortcut>` Deletes the specified snippet (alias `!ds`)  
-`!snippets` Lists all available snippets  
-`!version` Print the version of the bot you're running  
-`!newthread <user>` Opens a new thread with the specified user  
+These commands can be used anywhere on the inbox server, even outside ModMail threads.
 
-## Inside a modmail thread
-`!reply <text>` Sends a reply to the user in the format "(Role) User: text" (alias `!r`)  
-`!anonreply <text>` Sends an anonymous reply to the user in the format "Role: text" (alias `!ar`)  
-`!close <time>` Closes the modmail thread. If a time is specified, the thread is scheduled to be closed later. Scheduled closing is cancelled if a message is sent to or received from the user.  
-`!logs <page>` Lists previous modmail logs with this user. If there are a lot of logs, they will be paginated. In this case, you can specify the page number to view as an argument.  
-`!block <time>` Blocks the user from using modmail. If a time is specified, the block is temporary.  
-`!unblock <time>` Unblocks the user from using modmail. If a time is specified, the user will be scheduled to be unblocked after that time.  
-`!!shortcut` Reply with a snippet. Replace `shortcut` with the snippet's actual shortcut.  
-`!!!shortcut` Reply with a snippet anonymously. Replace `shortcut` with the snippet's actual shortcut.  
-`!move <category>` If `allowMove` is enabled, moves the thread channel to the specified category  
-`!loglink` Shows the link to the current thread's log  
-`!suspend` Suspend a thread. The thread will act as closed and not receive any messages until unsuspended.  
-`!unsuspend` Unsuspend a thread  
-`!id` Prints the user's ID  
-`!alert` Pings you when the thread gets a new reply. Use `!alert cancel` to cancel.  
+### `!newthread <userID>`
+Open a ModMail thread with a user.
 
-To automatically reply without using !reply or !r, [enable `alwaysReply` in the config](configuration.md).
+**Example:** `!newthread 106391128718245888`
+
+### `!logs <userID>`
+List previous ModMail logs with the specified user.
+
+**Example:** `!logs 106391128718245888`
+
+### `!block <userID>`
+Block the specified user from ModMail.
+
+**Example:** `!block 106391128718245888`
+
+### `!block <userID> <time>`
+Block the specified user from ModMail for a specified time.
+
+**Example:** `!block 106391128718245888 7d`
+
+### `!unblock <userID>`
+Unblock the specified user, allowing them to use ModMail again.
+
+**Example:** `!unblock 106391128718245888`
+
+### `!is_blocked <userID>`
+Check if the specified user is blocked.
+
+**Example:** `!is_blocked 106391128718245888`
+
+### `!version`
+Show the ModMail bot's version.
+
+## Snippets (canned messages)
+See the [📋 Snippets](snippets.md) page for more information!
diff --git a/docs/snippets.gif b/docs/snippets.gif
new file mode 100644
index 0000000000000000000000000000000000000000..f04d02d4652084ea706a94a7bc76e0a72462baa6
GIT binary patch
literal 13470
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
Z<oI>eA8+(u=jT5=cm8qP{?j`&{}(?f_K5%h

literal 0
HcmV?d00001

diff --git a/docs/snippets.md b/docs/snippets.md
new file mode 100644
index 0000000..3ba821a
--- /dev/null
+++ b/docs/snippets.md
@@ -0,0 +1,53 @@
+# 📋 Snippets
+Snippets, sometimes also called "canned messages" or "tags", are commonly used messages you can send in ModMail threads with just 1 command.
+
+![Snippets example](snippets.gif)
+
+## View available snippets
+### `!snippets` / `!s <shortcut>`
+
+To view all available snippets, use the command `!snippets`.
+
+To view a specific snippet's text, use the command `!s <shortcut>`.
+For example, to view the text of a snippet called "hi", run `!s hi`.
+
+## Creating snippets
+### `!s <shortcut> <text>`
+
+#### Example
+To create a snippet called "hi" with the text "Hello, how can we help you?", use the following command:
+
+`!s hi Hello, how can we help you?` 
+
+## Using snippets
+### `!!shortcut` / `!!!shortcut`
+Inside a ModMail thread, use `!!shortcut` to send a snippet to the user, replacing `shortcut` with the snippet's name.
+
+To send a snippet anonymously, use `!!!shortcut`.
+
+*The prefixes `!!` and `!!!` can be changed with the bot options `snippetPrefix` and `snippetPrefixAnon` respectively.*
+
+#### Example
+To send a snippet called "hi", use the following command:
+
+`!!hi`
+
+To send that same snippet anonymously, use the following command:
+
+`!!!hi`
+
+## Editing snippets
+### `!edit_snippet <shortcut> <text>` / `!es <shortcut> <text>`
+
+#### Example
+To edit a snippet called "hi" to say "Hello, how are you?", use the following command:
+
+`!es hi Hello, how are you?`
+
+## Deleting snippets
+### `!delete_snippet <shortcut>` / `!ds <shortcut>`
+
+#### Example
+To delete a snippet called "hi", use the following command:
+
+`!ds hi`