documentation improvements

1 files changed, 11 insertions, 4 deletions

diff --git a/doc/administration/upgrading.rst b/doc/administration/upgrading.rst
index 2b69e4c..c5e899d 100644
--- a/doc/administration/upgrading.rst
+++ b/doc/administration/upgrading.rst
@@ -44,10 +44,17 @@ new additional dependencies:
 
 .. code:: bash
 
-    .venv/bin/pip install .
+    .venv/bin/pip install path/to/fietsboek/source
 
-This step is similar to the command that you used when installing Fietsboek
-initially.
+If you downloaded Fietsboek from PyPI, you may need to tell ``pip`` explicitely
+to upgrade. Otherwise it will simply say that the package is already installed:
+
+.. code:: bash
+
+    .venv/bin/pip install --upgrade fietsboek
+
+In general, this step is similar to the command that you used when installing
+Fietsboek initially.
 
 Note that removed dependencies are not automatically removed. It might be worth
 to start with a clean virtual environment from time to time to clear out old
@@ -120,7 +127,7 @@ Restoring Data: Downgrading
 If you do not have old backups of your data, you can use ``fietsupdate`` to
 convert your data from the new format to the old one. Please note that the
 upgrade process can not always be undone: If an update deletes data, even the
-downgrade cannot fix it. In such cases, the only way to restore the data is
+downgrade cannot undo it. In such cases, the only way to restore the data is
 through a backup.
 
 To use ``fietsupdate`` to downgrade your data, run the following command,