diff --git a/swh/docs/sphinx/conf.py b/swh/docs/sphinx/conf.py
--- a/swh/docs/sphinx/conf.py
+++ b/swh/docs/sphinx/conf.py
@@ -23,6 +23,7 @@
 extensions = [
     "sphinx.ext.autodoc",
     "sphinx.ext.napoleon",
+    "sphinx.ext.intersphinx",
     "sphinxcontrib.httpdomain",
     "sphinx.ext.extlinks",
     "sphinxcontrib.images",
@@ -130,7 +131,10 @@
 html_last_updated_fmt = "%Y-%m-%d %H:%M:%S %Z"
 
 # refer to the Python standard library.
-intersphinx_mapping = {"python": ("https://docs.python.org/3", None)}
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3", None),
+    "swh-devel": ("https://docs.softwareheritage.org/devel", None),
+}
 
 # Redirects for pages that were moved, so we don't break external links.
 # Uses sphinx-reredirects
diff --git a/users/faq/index.rst b/users/faq/index.rst
--- a/users/faq/index.rst
+++ b/users/faq/index.rst
@@ -11,8 +11,7 @@
 Where can I find the SWH roadmap?
 ---------------------------------
 
-The roadmap is accessible on the `docs
-<https://docs.softwareheritage.org/devel/roadmap/roadmap-2021.html>`__.
+The roadmap is accessible on the :ref:`development docs <swh-devel:roadmap-2021>`.
 
 .. _faq_savecodenow: