Add docs for privileged intents

[ajax146]

No description provided.

[Mr-KayZ]

Couple of issues:

Guild Presences intent has zero documentation

• main.py uses discord.Intents.all() which does implictly request Guild Presences privileged intent.
• This doc is not present anywhere from what I searched, so you can do one of the following:
  • Remove discord.Intents.all() entirely and replace it with minimal intents objects that only enable members and message_content, and remove the word Presence from the README instruction.
  • Alternatively, create the doc for documentation/Privileged-Intents/Guild Presences.md.
• Either way, README.md needs to be updated as well after this.

Couple of modules are documented under the wrong module path

Some of the modules in Message Content.md are listed under the wrong path:

• moderation.listen - Actual path is in modules/administration/listen.py - Rename it to administration.listen in Message Content.md
• moderation.paste - Actual path is in modules/operation/paste.py - Rename it to operation.paste in Message Content.md

Minor issues

• Spelling mistake for moderation.event, the path is called modules/moderation/events.py - with the trailing s, so just rename moderation.event in Message Content.md to moderation.events.

[ajax146]

So as far as the first point goes, intent and privileged intent are not the same thing. There are 18 total intents on discord, only 3 of which are considered to be privileged. I have every intention of changing the code to remove the presences intent, since its not really used by this bot (see #1556)

My plan is to swap to default intents and then explicitly enable members and message_content for TS.
With refactoring (see #1555) I do believe the modmail bot will need nothing more than the default intents

As far as all the typos in here, I'll get to fixing them

[ajax146]

@Mr-KayZ I have re-written basically every word in the docs now, if you want to re-review it I am sure there are more typos to be found.

[dkay0670]

Is this the documentation that is getting submitted to Discord for the application?

[ajax146]

I am not sure exactly what discord will be asking for, as I am still not allowed to apply. Discord is batching opening applications to developers so I will have to wait my turn to see what is asked for.

The intention is to use this as documentation for what privileged intents are being used and why we need them, as I am confident that will be a question asked.