diff --git a/docs/Makefile b/docs/Makefile
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -25,6 +25,7 @@
 sphinx/html: links-stamp apidoc-stamp images-stamp rec-build-stamp
 
 links-stamp:
+	mkdir -p sources/swh
 	bin/ln-sphinx-subprojects
 	touch $@
 
diff --git a/docs/bin/ln-sphinx-subprojects b/docs/bin/ln-sphinx-subprojects
--- a/docs/bin/ln-sphinx-subprojects
+++ b/docs/bin/ln-sphinx-subprojects
@@ -10,6 +10,9 @@
         if [ ! -e "$pymodule" -a -d "../../${pymodule}/docs" ] ; then
             ln -s "../../${pymodule}/docs" "$pymodule"
         fi
+        if [ -d "../../${pymodule}/swh" ] ; then
+            cp -r -f --symbolic-link $(realpath ../../${pymodule}/swh/*) sources/swh/
+        fi
     done
 }
 
@@ -22,6 +25,7 @@
             rm "$pymodule"
         fi
     done
+    rm -rf sources/swh/
 }
 
 if [ "$1" = "--remove" ] ; then
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
@@ -85,6 +85,9 @@
     "swh-icinga-plugins/index.rst",
     "swh.loader.cvs.rcsparse.setup.rst",
     "apidoc/swh.loader.cvs.rcsparse.setup.rst",
+    "**/swh/lister/maven/README.md",
+    "**/swh/loader/cvs/cvs2gitdump/README.md",
+    "**/swh/web/tests/resources/contents/code/extensions/test.md",
 ]
 
 # The name of the Pygments (syntax highlighting) style to use.