diff --git a/docs/developer-setup.rst b/docs/developer-setup.rst
--- a/docs/developer-setup.rst
+++ b/docs/developer-setup.rst
@@ -94,6 +94,13 @@
     (swh) ~/swh-environment$ pip install $(./bin/pip-swh-packages --with-testing)
     [...]
 
+.. Note:: If you experience issues in :program:`pip` package resolution, try using
+   ``--use-deprecated=legacy-resolver`` CLI option.
+   It can be set in :file:`~/.config/pip/pip.conf` until the issue is solved::
+
+      [install]
+      use-deprecated=legacy-resolver
+
 Executing unit tests
 --------------------