diff --git a/docs/upgrade.rst b/docs/upgrade.rst
--- a/docs/upgrade.rst
+++ b/docs/upgrade.rst
@@ -81,10 +81,14 @@ If you originally installed using pip, i
 
     pip install --upgrade kallithea
 
-If you originally installed from version control, it is as simple as::
+If you originally installed from version control, assuming you did not make
+private changes (in which case you should adapt the instructions accordingly)::
 
     cd my-kallithea-clone
-    hg pull -u
+    hg parent   # make a note of the original revision
+    hg pull
+    hg update
+    hg parent   # make a note of the new revision
     pip install --upgrade -e .
     kallithea-cli front-end-build