diff --git a/docs/administrator_documentation/installation_docs/debian.md b/docs/administrator_documentation/installation_docs/debian.md
index 475982c21..65782058a 100644
--- a/docs/administrator_documentation/installation_docs/debian.md
+++ b/docs/administrator_documentation/installation_docs/debian.md
@@ -126,7 +126,7 @@ You're done! These commands put the software in the correct location for Funkwha
 
 The Funkwhale API is written in Python. You need to install the API's package to run the software:
 
-1. Setup a Python virtual environment:
+1. Set up a Python virtual environment:
 
    ```{code-block} sh
    cd /srv/funkwhale
@@ -255,7 +255,7 @@ That's it! You've finished setting up your database.
 
 ## 7. Set up Funkwhale
 
-Once you have got your database up and running, you can get Funkwhale ready to launch. Use the built-in `funkwhale-manage` command line interface to get things ready.
+Once you've got your database up and running, you can get Funkwhale ready to launch. Use the built-in `funkwhale-manage` command line interface to get things ready.
 
 ### Create a superuser for your pod
 
diff --git a/docs/administrator_documentation/upgrade_docs/debian.md b/docs/administrator_documentation/upgrade_docs/debian.md
index 803bb0a7a..40d6b40d0 100644
--- a/docs/administrator_documentation/upgrade_docs/debian.md
+++ b/docs/administrator_documentation/upgrade_docs/debian.md
@@ -30,9 +30,9 @@ If you installed Funkwhale following the [Debian guide](../installation_docs/deb
    export FUNKWHALE_VERSION={sub-ref}`version`
    ```
 
-2. Follow the [3. Download Funkwhale](../installation_docs/debian.md#3-download-funkwhale) installation section.
+2. Follow the [Download Funkwhale](../installation_docs/debian.md#3-download-funkwhale) instructions in the installation guide.
 
-3. Follow the [4. Install the Funkwhale API](../installation_docs/debian.md#4-install-the-funkwhale-api) installation section.
+3. Follow the [Install the Funkwhale API](../installation_docs/debian.md#4-install-the-funkwhale-api) instructions in the installation guide.
 
 ## Update your Funkwhale instance