diff --git a/docs/_static/style.css b/docs/_static/style.css index 83540b63b..5f2ea4050 100644 --- a/docs/_static/style.css +++ b/docs/_static/style.css @@ -47,8 +47,10 @@ div#welcome-to-discord-py > h1 { /* no disgusting background in FAQ */ div.topic { background-color: transparent; + border: none; } -div.topic { - border: none; +/* give images some breathing room */ +img { + padding-bottom: 10px; } diff --git a/docs/discord.rst b/docs/discord.rst index 1929c3109..2c940d0f5 100644 --- a/docs/discord.rst +++ b/docs/discord.rst @@ -11,7 +11,7 @@ Creating a Bot account is a pretty straightforward process. 2. Navigate to the `application page `_ 3. Click on the "New App" button. - .. image:: /images/discord_create_new_app_button.png + .. image:: /images/discord_create_app_button.png :alt: The new app button. 4. Give the application a name and a description if wanted and click "Create App". @@ -19,28 +19,24 @@ Creating a Bot account is a pretty straightforward process. - You can also put an avatar you want your bot to use, don't worry you can change this later. - **Leave the Redirect URI(s) blank** unless are creating a service. - .. image:: /images/discord_new_app_form.png + .. image:: /images/discord_create_app_form.png :alt: The new application form filled in. 5. Create a Bot User by clicking on the accompanying button and confirming it. - .. image:: /images/discord_create_bot_user_button.png + .. image:: /images/discord_create_bot_user.png :alt: The Create a Bot User button. 6. Make sure that **Public Bot** is ticked if you want others to invite your bot. - You should also make sure that **Require OAuth2 Code Grant** is unchecked unless you are developing a service that needs it. If you're unsure, then **leave it unchecked**. - .. figure:: /images/discord_finished_bot_user.png - - How the Bot User options should look like for most people. + .. image:: /images/discord_bot_user_options.png + :alt: How the Bot User options should look like for most people. 7. Click to reveal the token. - **This is not the Client Secret** - - .. figure:: /images/discord_reveal_token.png - - How the token reveal button looks like. + - Look at the image above to see where the **Token** is. And that's it. You now have a bot account and you can login with that token. @@ -65,8 +61,8 @@ Copy paste that into the pre-formatted URL: https://discordapp.com/oauth2/authorize?client_id=YOUR_CLIENT_ID&scope=bot&permissions=0 Replace ``YOUR_CLIENT_ID`` with the Client ID we got in the previous step. For example, -in the image above our client ID is 312718641634213889 so the resulting URL would be -https://discordapp.com/oauth2/authorize?client_id=312718641634213889&scope=bot&permissions=0 +in the image above our client ID is 312777964700041216 so the resulting URL would be +https://discordapp.com/oauth2/authorize?client_id=312777964700041216&scope=bot&permissions=0 (note that this bot has been deleted). Now you can click the link and invite your bot to any server you have "Manage Server" permissions on. @@ -81,7 +77,7 @@ the guild, they will be granted a managed role that contains the permissions you If the permissions is 0, then no special role is created. This ``permissions`` value is calculated based on bit-wise arithmetic. Thankfully, people have -created a calculate that makes it easy to calculate the permissions necessary visually. +created a calculator that makes it easy to calculate the permissions necessary visually. - https://discordapi.com/permissions.html - https://finitereality.github.io/permissions/ diff --git a/docs/images/discord_bot_user_options.png b/docs/images/discord_bot_user_options.png new file mode 100644 index 000000000..24537991d Binary files /dev/null and b/docs/images/discord_bot_user_options.png differ diff --git a/docs/images/discord_client_id.png b/docs/images/discord_client_id.png index 04710f325..fc4cbc0b4 100644 Binary files a/docs/images/discord_client_id.png and b/docs/images/discord_client_id.png differ diff --git a/docs/images/discord_create_app_button.png b/docs/images/discord_create_app_button.png new file mode 100644 index 000000000..dd47be15d Binary files /dev/null and b/docs/images/discord_create_app_button.png differ diff --git a/docs/images/discord_create_app_form.png b/docs/images/discord_create_app_form.png new file mode 100644 index 000000000..a204ca84a Binary files /dev/null and b/docs/images/discord_create_app_form.png differ diff --git a/docs/images/discord_create_bot_user.png b/docs/images/discord_create_bot_user.png new file mode 100644 index 000000000..791cb79a9 Binary files /dev/null and b/docs/images/discord_create_bot_user.png differ diff --git a/docs/images/discord_create_bot_user_button.png b/docs/images/discord_create_bot_user_button.png deleted file mode 100644 index f87940abe..000000000 Binary files a/docs/images/discord_create_bot_user_button.png and /dev/null differ diff --git a/docs/images/discord_create_new_app_button.png b/docs/images/discord_create_new_app_button.png deleted file mode 100644 index 78a099dde..000000000 Binary files a/docs/images/discord_create_new_app_button.png and /dev/null differ diff --git a/docs/images/discord_finished_bot_user.png b/docs/images/discord_finished_bot_user.png deleted file mode 100644 index 09aff891b..000000000 Binary files a/docs/images/discord_finished_bot_user.png and /dev/null differ diff --git a/docs/images/discord_new_app_form.png b/docs/images/discord_new_app_form.png deleted file mode 100644 index 68409a6cf..000000000 Binary files a/docs/images/discord_new_app_form.png and /dev/null differ diff --git a/docs/images/discord_reveal_token.png b/docs/images/discord_reveal_token.png deleted file mode 100644 index 92d5492a6..000000000 Binary files a/docs/images/discord_reveal_token.png and /dev/null differ diff --git a/docs/migrating.rst b/docs/migrating.rst index 781fffab3..bc1551a3f 100644 --- a/docs/migrating.rst +++ b/docs/migrating.rst @@ -238,7 +238,7 @@ Earlier, in v0.11.0 a :class:`VoiceState` class was added to refer to voice stat However, it was transparent to the user. In an effort to make the library save more memory, the voice state change is now more visible. -The only way to access voice attributes if via the :attr:`Member.voice` attribute. Note that if +The only way to access voice attributes is via the :attr:`Member.voice` attribute. Note that if the member does not have a voice state this attribute can be ``None``. Quick example: ::