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,14 @@
     (swh) ~/swh-environment$ pip install $(./bin/pip-swh-packages --with-testing)
     [...]
 
+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
 --------------------