FAQ page review and a few other fixes

.github/CONTRIBUTING.md

@@ -38,6 +38,54 @@ Tabs are boxes of content that show a list of tab titles, and the reader can vie
 
 To start a group of tabs, use the `{% tabs %}` tag. For each single tab, wrap them in `{% tab title="TITLE" %}`, replacing the title accordingly, and `{% endtab %}`. End the whole group of tabs with `{% endtabs %}`.
 
+## Style Guide
+
+### Do:
+
+- Communicate! Ask questions and make suggestions. It's ok to be wrong; Learn and try again, we love it!
+- Always add a hyperlink to the command's page when mentioned
+- Submit pull requests to the testing branch, not the main branch
+- Retain as much information as possible while remaining concise. It can be a difficult balance at times, but mistakes are ok! Pull requests and the testing branch allow for plenty of feedback and revision
+- Add additional relevant information when it is missing or improves the section
+- Use info hints for information that is indirectly related
+- Structure pages and sections in the order a user would need to set the bot up, then use comfortably, then in order of importance. I.e., make sure the bot works, then set it to a comfortable language, then continue to moderation set up
+- Tables containing specific values, such as the log names, should be alphabetical
+- Keep the main page as a summary/overview; Add the specific stuff to the dedicated/relevant page
+- Add explanations for suggestions. Your way of thinking might not be immediately clear to others, but that doesn't make it bad or wrong; Even if it's just a gut feeling, let us know!
+
+
+Screenshots:
+
+- Add screenshots where relevant, clarifying, needed, etc.
+- Set your display name to `MoonlightCapital`
+- Set your profile picture to [this image](https://cdn.discordapp.com/attachments/484218269662707734/1362150383258173491/davatar3.png)
+- Add a role with the color `#008080` to yourself and the bot
+- Compress screenshots (but don't lose quality); [ImageCompressor](https://imagecompressor.com/) is suitable for this
+- Keep the outer margins/blank space of screenshots uniform
+- Edit out dates, hovered message options, and other visual discrepancies in screenshots
+- Use the "Ash" theme, with default spacing/font size/etc.
+
+
+
+###	Don't:
+
+- Stay silent. We want you to ask questions, we want your input. MoonlightBot is built for you, the user, and your contributions help us improve! Even if you just ask one question, you might be the 15th person to ask it, letting us know our documentation could use improvement! Being an active member of the community helps everyone
+- Ramble about something in the documentation. Keep contributions short and sweet. If you need help, feel free to ask for feedback!
+- Remove information if avoidable. If important information needs to be removed from one section, try to find a new place for it.
+- Make vague statements about functions and features.
+- Randomly add sections or other information, or shuffle orders without a clear improvement in mind.
+- Submit suggestions without some explanation or thought process
+- Go in-depth on the main page
+
+
+Screenshots:
+
+- Use a theme other than "Ash"
+- Have evidence of a Discord client being used (uninstall it or switch to the default client for screenshots, then switch back after)
+- Submit unprocessed screenshots
+- Submit low-resolution screenshots
+- Submit uncompressed screenshots
+
 ## Commit and branch naming
 
 Try to keep the names of branches and commits meaningful.

README.md

@@ -47,7 +47,7 @@ MoonlightBot provides easy and dynamic role management by staff and members alik
 * All active temporary roles can be listed with [`/list-temproles`](./role-management-commands/list-temproles.md)
 * Roles added to members can be automatically changed to a temporary role using the [`detect-assignment` config option](./management-commands/config.md#roles-detect-assignment)
 
-You can also permanently assign or remove any role to a user with [`/role`](./role-management-commands/role.md), or setup [Reaction Roles](./start-up/setting-up-reaction-roles.md) and [`/selfrole`](./role-management-commands/selfrole.md)s that members can self-assign
+You can also permanently assign or remove any role to a user with [`/role`](./role-management-commands/role.md), or setup temporary or permanent [Reaction Roles](./start-up/setting-up-reaction-roles.md) and [`/selfrole`](./role-management-commands/selfrole.md)s that members can self-assign.
 
 ## Command Permissions
 

support/premium.md

@@ -91,7 +91,9 @@ Activating your subscription is a seamless process that only requires four steps
 <figure><img src="/.gitbook/assets/PremiumSuccessfulActivationMessage.png" alt=""><figcaption></figcaption></figure>
 
 3. **Verify the bot is legitimate** by clicking on the bot name to view information. The main instance of MoonlightBot has a verified check mark next to the username and was created on March 18th, 2018. The Premium instance also has a verified check mark next to the username and was created on March 27, 2020!
-["MoonlightBot Premium was created on March 27, 2020"](/.gitbook/assets/PremiumMiniProfile.png)
+
+<figure><img src="/.gitbook/assets/PremiumMiniProfile.png" alt="MoonlightBot Premium was created on March 27, 2020"><figcaption>MoonlightBot Premium was created on March 27, 2020</figcaption></figure>
+
 4. If the bot is legitimate, click on the "Add me to your server" button at the end of the confirmation message. Make sure you **do not uncheck** the "View Audit Log" permission in the procedure, as that is required to verify it was you who added the bot and mark you as representative
 
 Done!
@@ -130,7 +132,7 @@ If you purchased or received a lifetime subscription in the past, it will remain
 
 ## Disclaimer
 
-Premium subscribers are subject to the [Resource provider agreement](/policies/acceptable-use-policy.md#6---resource-providerdonation-policy) of the [Acceptable Use Policy](/policies/acceptable-use-policy.md).
+Premium subscribers are subject to the [Resource provider agreement](/policies/acceptable-use-policy.md#id-6-resource-provider-donation-policy) of the [Acceptable Use Policy](/policies/acceptable-use-policy.md).
 
 All perks are meant to come "within reason". We will turn down requests that cause excessive strain on our systems, personnel or come with certain caveats that may not be appropriate for our ecosystem. In doubt, consult our Staff first.
 

support/volunteering.md

@@ -17,7 +17,7 @@ Their mission is to uncover bugs and annoyances that might hinder a smooth user
 * An opportunity to learn how to get the most from MoonlightBot - and many other Discord apps
 * Access to and testing of new features as they are developed
 * The ability to request small changes, work closely with the developer, and have a voice in important decisions
-* Your name on the [Special Thanks Page](/special-thanks.md#testers)
+* Your name on the [Special Thanks Page](special-thanks.md#testers)
 
 ### Becoming a Tester
 
@@ -37,7 +37,7 @@ MoonlightBot translators assist in translating the commands, responses and messa
 
 * A colorful, prominent role in the server to show everyone you're one of us
 * MoonlightBot Premium (Basic tier), once you have translated 50 strings
-* Your name on the [Special Thanks Page](/special-thanks.md#translators)
+* Your name on the [Special Thanks Page](special-thanks.md#translators)
 
 ### Becoming a Translator
 
@@ -66,7 +66,7 @@ They create new documentation pages as new functions are added to the bot, and u
 * A MoonlightBot Premium subscription (Super tier)
 * Access to and testing of new features as they are developed
 * Earliest possible access to upcoming updates
-* Your name on the [Special Thanks Page](/special-thanks.md#documentation-writers)
+* Your name on the [Special Thanks Page](special-thanks.md#documentation-writers)
 
 ### Becoming a Documentation Writer