From 528942594ce5e0195e57d5c0aa4ef104d9becdd2 Mon Sep 17 00:00:00 2001
From: Dragory <2606411+Dragory@users.noreply.github.com>
Date: Thu, 5 Dec 2019 20:34:40 +0200
Subject: [PATCH] Clarify docs on single-server and two-server setups. Move
 single-server setup to be the first one.

---
 docs/setup.md | 24 ++++++++++++++++--------
 1 file changed, 16 insertions(+), 8 deletions(-)

diff --git a/docs/setup.md b/docs/setup.md
index 660acd4..8c22b00 100644
--- a/docs/setup.md
+++ b/docs/setup.md
@@ -19,8 +19,22 @@ To keep it online, you need to keep the bot process running.
 4. Download the latest bot version from [the releases page](https://github.com/Dragory/modmailbot/releases) and extract it to a folder
 5. In the bot's folder, make a copy of the file `config.example.ini` and rename the copy to `config.ini`
 
+## Single-server setup
+In this setup, modmail threads are opened on the main server in a special category.
+This is the recommended setup for small and medium sized servers.
+
+1. Open `config.ini` in a text editor and fill in the required values. `mainGuildId` and `mailGuildId` should both be set to your server's id.
+2. On a new line at the end of `config.ini`, add `categoryAutomation.newThread = CATEGORY_ID_HERE`
+    - Replace `CATEGORY_ID_HERE` with the ID of the category where new modmail threads should go
+3. Make sure the bot has `Manage Channels`, `Manage Messages`, and `Attach Files` permissions in the category
+4. **[🏃 Start the bot!](starting-the-bot.md)**
+5. Want to change other bot options? See **[📝 Configuration](configuration.md)**
+
 ## Two-server setup
 In this setup, modmail threads are opened on a separate inbox server.
+This is the recommended setup for large servers that get a lot of modmails, where a single-server setup could get messy.
+You might also want this setup for privacy concerns*.
+
 1. Create an inbox server on Discord
 2. Invite the bot to the inbox server.
 3. Open `config.ini` in a text editor and fill in the values
@@ -28,11 +42,5 @@ In this setup, modmail threads are opened on a separate inbox server.
 5. **[🏃 Start the bot!](starting-the-bot.md)**
 5. Want to change other bot options? See **[📝 Configuration](configuration.md)**
 
-## Single-server setup
-In this setup, modmail threads are opened on the main server in a special category.
-1. Open `config.ini` in a text editor and fill in the required values. `mainGuildId` and `mailGuildId` should both be set to your server's id.
-2. On a new line at the end of `config.ini`, add `categoryAutomation.newThread = CATEGORY_ID_HERE`
-    - Replace `CATEGORY_ID_HERE` with the ID of the category where new modmail threads should go
-3. Make sure the bot has `Manage Channels`, `Manage Messages`, and `Attach Files` permissions in the category
-4. **[🏃 Start the bot!](starting-the-bot.md)**
-5. Want to change other bot options? See **[📝 Configuration](configuration.md)**
+*\* Since all channel names, even for channels you can't see, are public information through the API, a user with a
+modified client could see the names of all users contacting modmail through the modmail channel names.*