diff --git a/docs/bot_application_guide.rst b/docs/bot_application_guide.rst index c3697083a..0fc4a64e9 100644 --- a/docs/bot_application_guide.rst +++ b/docs/bot_application_guide.rst @@ -56,7 +56,7 @@ Continue to the next section to enable privileged intents. Enabling Privileged Intents ------------------------------- .. warning:: - :ref:`As explained in this page `, Red Bot requires all intents. + :ref:`Red Bot requires all intents. ` \This section is required. 1. Make sure you're logged on to the `Discord website `_. @@ -75,6 +75,6 @@ Enabling Privileged Intents .. warning:: Red bots with over 100 servers require `bot verification `_ which is not covered in this guide. - Remember that as explained :ref:`here ` we do not support public bots. We encourage you to read that page before scaling up your bot. + Remember that :ref:`we do not support public bots `. We encourage you to read that page before scaling up your bot. *Parts of this guide have been adapted from* `discord.py intro `_ *and* `discord.py privileged intents `_. diff --git a/docs/getting_started.rst b/docs/getting_started.rst index 917555860..bfad407fe 100644 --- a/docs/getting_started.rst +++ b/docs/getting_started.rst @@ -13,7 +13,7 @@ This is a quick start guide for a general usage. .. note:: If you haven't installed Red, please do it by following - the :ref:`installation guides
`. + one of the `installation guides `. Assuming you correctly installed Red, you should have a window like this: @@ -266,14 +266,14 @@ If you want to do it, follow these steps. basics of the Unix commands, such as navigating the system files or use a terminal text editor. - You should follow `this guide + You should read `DigitalOcean's tutorial: An Introduction to Linux Basics `_ - from DigitalOcean which will introduce you to the Linux basics. + if you have not used Linux before. 1. **Find a host** You need to find a server to host Red. You can rent a VPS (it can be free) - on an online service. Please check :ref:`this page ` for + on an online service. Please check :ref:`this list of hosts ` for more information. You can also buy a Raspberry Pi (~$20), which is a micro-computer that will @@ -307,8 +307,8 @@ If you want to do it, follow these steps. 3. **Install and set up Red** - Just follow one of the Linux installation guide. We provide guides for the - most used distributions. Check the :ref:`home page
` and search for + Follow one of the Linux installation guides. We provide guides for the + most used distributions. Check the `list of install guides ` and search for your distribution. 4. **Set up an auto-restart** @@ -318,7 +318,7 @@ If you want to do it, follow these steps. side task and handle fatal errors, so you can just leave your server running and enjoy Red! - For that, just follow :ref:`this guide `. + For that, follow :ref:`the systemd service guide `. .. _getting-started-userdocs: diff --git a/docs/guide_trivia_list_creation.rst b/docs/guide_trivia_list_creation.rst index 247b00a48..d51f95725 100644 --- a/docs/guide_trivia_list_creation.rst +++ b/docs/guide_trivia_list_creation.rst @@ -118,7 +118,7 @@ As you've added more questions, your file should look something like this: - $25000 You can keep adding questions until you are satisfied, and then you can upload and -play your very own trivia! See :ref:`here ` for more details. +play your very own trivia! See :ref:`[p]triviaset custom ` for more information. Still stuck? Take a look at `the core trivia lists `_ diff --git a/docs/host-list.rst b/docs/host-list.rst index 5ac1ec06b..b24048472 100644 --- a/docs/host-list.rst +++ b/docs/host-list.rst @@ -8,7 +8,7 @@ Hosting Information .. note:: This doc is written for the :ref:`hosting section ` - of the :ref:`getting started ` guide. Please take a look + of the :ref:`getting started guide `. Please take a look if you don't know how to host Red. @@ -41,9 +41,9 @@ Hosting on a VPS or Dedicated Server .. warning:: Please be aware that a Linux server is controlled through a command line. - If you don't know Unix basics, please take a look at `this guide - `_ - from DigitalOcean which will introduce you to the Linux basics. + If you don't know Unix basics, please take a look at + `DigitalOcean's tutorial: An Introduction to Linux Basics + `_. ------------ diff --git a/docs/install_guides/_includes/linux-preamble.rst b/docs/install_guides/_includes/linux-preamble.rst index b9699c258..54eb36996 100644 --- a/docs/install_guides/_includes/linux-preamble.rst +++ b/docs/install_guides/_includes/linux-preamble.rst @@ -1,5 +1,5 @@ .. warning:: For safety reasons, DO NOT install Red with a root user. If you are unsure how to create - a new user on Linux, see `this guide by DigitalOcean + a new user on Linux, see `DigitalOcean's tutorial: How To Create a New Sudo-enabled User `_. diff --git a/docs/install_guides/windows.rst b/docs/install_guides/windows.rst index d58ed9b38..6d5de5efe 100644 --- a/docs/install_guides/windows.rst +++ b/docs/install_guides/windows.rst @@ -166,8 +166,7 @@ Once done setting up the instance, run the following command to run Red: redbot It will walk through the initial setup, asking for your token and a prefix. -You can find out how to obtain a token with -`this guide <../bot_application_guide>`. +`See how to obtain a token. <../bot_application_guide>` .. tip:: If it's the first time you're using Red, you should check our `getting-started` guide diff --git a/docs/intents.rst b/docs/intents.rst index 38b014d28..2bdd548f0 100644 --- a/docs/intents.rst +++ b/docs/intents.rst @@ -123,14 +123,11 @@ The *bandaid fix* is for you to change your bot's prefix to a mention and a good still work. You will however lose many functions, namely anything that relies on seeing message content to act. |br| The more *proper fix* is also not easy. You will need to justify your need for the message intent to Discord and they will only accept "compelling use cases". -`It is not known `_ -what those even entail at this point, but they have already stated that "parsing commands" is not a valid justification. |br| -To make the matter worse, Discord is making a huge push for all bot developers to implement -`slash commands `_, which at the moment +`It is not known what those even entail `_ at this point, but they have already stated that "parsing commands" is not a valid justification. |br| +To make the matter worse, Discord is making `a huge push for all bot developers to implement slash commands `_, which at the moment are rather lacking in features and cannot cover all the functionalities that standard commands offer. |br| Discord staff -`stated `_ -that they will want your bot to have slash commands when you ask for message intent. |br| +`stated that they will want your bot to have slash commands when you ask for message intent `_. |br| Slash commands might very well turn out to be a big undertaking for the Red team to implement, even more now that our underlying library, `discord.py `_, has been discontinued. |br| The time window that Discord is giving us to adapt is very narrow: **Red will likely not be able to support slash