docs: Huge Docs revamp

[mAxYoLo01]

About

This PR's goal is to massively revamp the docs to a more readable version.

In this PR is included:

• Rethink the general layout of the docs to make them more user-friendly, and highlight the important part
• Remove certain "private" files from being generated in docs (cache, error, gateway, ...) as they should not be public
• Hide private methods & functions from the docs
• Fix multiple docs generation warnings & errors
• Remove all ? from docstrings
• Combining :param: and :type: into a single line in docstrings

Checklist

• The pre-commit code linter has been run over all edited files to ensure the code is linted.
• I've ensured the change(s) work on 3.8.6 and higher.

I've made this pull request: (check all that apply)

• For the documentation
• To add a new feature
• As a general enhancement
• As a refactor of the library/the library's code
• To fix an existing bug
• To resolve #ISSUENUMBER

This is:

• A breaking change

[EepyElvyra]

target branch. Also why the removal of error docs?

[mAxYoLo01]

Here is the new layout of the docs:

[mAxYoLo01]

target branch. Also why the removal of error docs?

I feel like since this is such a massive update, it belongs in unstable. Not only docs have been changed. Also, the docs branch is quite behind.

The error page had nothing important in it, kind of like the cache one, nothing that a random person needs to see.

[EepyElvyra]

target branch. Also why the removal of error docs?

I feel like since this is such a massive update, it belongs in unstable. Not only docs have been changed. Also, the docs branch is quite behind.

The error page had nothing important in it, kind of like the cache one, nothing that a random person needs to see.

Alright, that is fair

and yeah I didn't see the code changes tbf

[mAxYoLo01]

I'm going to have to regenerate all the locale docs too with all the modifications, should I do it here or another PR?

[EepyElvyra]

Has http been removed from index and searching?

[mAxYoLo01]

Has http been removed from index and searching?

Yes, as these methods should not be used by developers except if they have very good reasons to, which in this case I would guess they would check the source code at this point.

[EepyElvyra]

Has http been removed from index and searching?

Yes, as these methods should not be used by developers except if they have very good reasons to, which in this case I would guess they would check the source code at this point.

Yeah I'm pro removing, sick of seeing "why is interactions.api.http.guild.GuildRequest.get_member(id) not working" xD

[EepyElvyra]

I think this is fine and I don't want to make you a hell conflict when I make another refactor, or the other way around