diff --git a/doc/2-getting-started.md b/doc/2-getting-started.md
index 42164450d..e74e844a5 100644
--- a/doc/2-getting-started.md
+++ b/doc/2-getting-started.md
@@ -1074,29 +1074,34 @@ to the default used in Icinga 2. Make sure to clear the cache afterwards.
#### Icinga Web on Debian systems
-Since Icinga Web 1.11.1-2 on Debian and Ubuntu, the IDO autoconfiguration has been moved to additional packages.
+Since Icinga Web `1.11.1-2` the IDO auto-configuration has been moved into
+additional packages on Debian and Ubuntu.
-The package `icinga-web` no longer configures the IDO connection, you can use one of the config packages:
+The package `icinga-web` no longer configures the IDO connection. You must now
+use one of the config packages:
- `icinga-web-config-icinga2-ido-mysql`
- `icinga-web-config-icinga2-ido-pgsql`
-These packages take care of setup up the IDO connection, enabling the command pipe from Icinga Web
-and depend on the corresponding packages of Icinga 2.
+These packages take care of setting up the [DB IDO](#configuring-db-ido) configuration,
+enabling the external command pipe for Icinga Web and depend on
+the corresponding packages of Icinga 2.
-Please read the README.Debian files for details and how to do advanced configuration:
+Please read the `README.Debian` files for details and advanced configuration:
- `/usr/share/doc/icinga-web/README.Debian`
- `/usr/share/doc/icinga-web-config-icinga2-ido-mysql/README.Debian`
- `/usr/share/doc/icinga-web-config-icinga2-ido-pgsql/README.Debian`
-If you change the XML configuration of Icinga Web, make sure to clear the config cache:
+When changing Icinga Web configuration files make sure to clear the config cache:
# /usr/lib/icinga-web/bin/clearcache.sh
> **Note**
>
-> When you use an older version of icinga-web you should install it with:
+> If you are using an older version of Icinga Web, install it like this and adapt
+> the configuration manually as shown in [the RPM notes](#icinga-web-rpm-notes):
+>
> `apt-get install --no-install-recommends icinga-web`
#### Setting Up Icinga Web Summary