diff --git a/docs/developer-setup.rst b/docs/developer-setup.rst
--- a/docs/developer-setup.rst
+++ b/docs/developer-setup.rst
@@ -61,10 +61,6 @@
     ~$ cd swh-environment
     ~/swh-environment$
 
-Checkout all the swh packages source repositories::
-
-    ~/swh-environment$ ./bin/update
-
 Create a virtualenv::
 
     ~/swh-environment$ source /usr/share/virtualenvwrapper/virtualenvwrapper.sh
@@ -72,6 +68,11 @@
     [...]
     (swh) ~/swh-environment$
 
+Checkout all the swh packages source repositories::
+
+    (swh) ~/swh-environment$ pip install pre-commit
+    (swh) ~/swh-environment$ ./bin/update
+
 In the future you can re-activate the created virtualenv with::
 
    $ workon swh
@@ -89,7 +90,7 @@
 
 Install all the swh packages (in develop mode)::
 
-    (swh) ~/swh-environment$ pip install pre-commit flake8 pifpaf tox wheel mypy
+    (swh) ~/swh-environment$ pip install flake8 pifpaf tox wheel mypy
     (swh) ~/swh-environment$ pip install $(./bin/pip-swh-packages)
     (swh) ~/swh-environment$ pip install $(./bin/pip-swh-packages --with-testing)
     [...]