diff --git a/docs/content/setup/debian.md b/docs/content/setup/debian.md
index a1d751411f6..118ed05e09b 100644
--- a/docs/content/setup/debian.md
+++ b/docs/content/setup/debian.md
@@ -19,7 +19,7 @@ sudo apt update
 sudo dpkg -i monkey_island.deb  # this might print errors
 ```
 
-If at this point, dpkg printed errors that look like this:
+If, at this point, you receive dpkg printed errors that look like this:
 
 ```sh
 dpkg: error processing package gc-monkey-island (--install):
@@ -28,7 +28,7 @@ Errors were encountered while processing:
     gc-monkey-island
 ```
 
-That just means that not all dependencies were pre-installed on your system. That’s no problem! Just run the following command, which will install all dependencies and then install the Monkey Island:
+It just means that not all dependencies were pre-installed on your system. That’s no problem! Just run the following command, which will install all dependencies, and then install the Monkey Island:
 
 ```sh
 sudo apt install -f
@@ -38,7 +38,7 @@ sudo apt install -f
 
 ### Trying to install on Ubuntu <16.04
 
-If you’re trying to install the Monkey Island on Ubuntu 16.04 or older, you need to install the dependencies yourself, since Python 3.7 is only installable from the `deadsnakes` PPA. To install the Monkey Island on Ubuntu 16.04, follow the following steps:
+If you’re trying to install the Monkey Island on Ubuntu 16.04 or older, you need to install the dependencies yourself, since Python 3.7 is only installable from the `deadsnakes` PPA. To install the Monkey Island on Ubuntu 16.04, follow these steps:
 
 ```sh
 sudo apt update
@@ -57,8 +57,8 @@ To check the status of the Monkey Island after the installation, run the followi
 
 ## Upgrading
 
-To upgrade when a new version comes out, download the new Monkey `.deb` file and install it. You should see a message like `Unpacking monkey-island (1.8.2) over (1.8.0)`. After which, the installation should complete successfully.
+Currently, there's no "upgrade-in-place" option when a new version is released. To get the updated version, download the new `.deb` file and install it. You should see a message like `Unpacking monkey-island (1.8.2) over (1.8.0)`. After which, the installation should complete successfully.
 
-If you'd like to keep your existing configuration, you can export it to a file by using the Export button and then import it to the new server.
+If you'd like to keep your existing configuration, you can export it to a file using the *Export config* button and then import it to the new Monkey Island.
 
 ![Export configuration](../../images/setup/export-configuration.png "Export configuration")