diff --git a/Makefile.sphinx b/Makefile.sphinx
--- a/Makefile.sphinx
+++ b/Makefile.sphinx
@@ -42,6 +42,8 @@
 	find $(shell pwd)/apidoc -name "*.rst" | xargs sed -i '1i:orphan:\n'
 	touch $@
 
+assets:
+
 .PHONY: clean clean-apidoc
 clean: sphinx/clean clean-apidoc
 clean-apidoc:
diff --git a/docs/Makefile b/docs/Makefile
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -33,7 +33,7 @@
 # non-sphinx managed documentation artifacts (e.g., schema diagrams) are also
 # built.
 rec-build-stamp: $(wildcard ../../swh-*/docs/*.rst)
-	$(MAKE) -C ../../ docs
+	$(MAKE) -C ../../ docs-assets
 	touch $@
 
 clean: sphinx/clean
diff --git a/docs/index.rst b/docs/index.rst
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -116,3 +116,13 @@
 * :ref:`modindex`
 * `URLs index <http-routingtable.html>`_
 * :ref:`search`
+
+
+.. ensure sphinx does not complain about index files not being included
+
+.. toctree::
+   :hidden:
+   :glob:
+
+   getting-started
+   swh-*/index