docs/: add sphinx apidoc generation skeleton

change cherry picked from python module template commit 71b117ba0cf9f1251b1cac26d0994df03a4c787d

docs/: add sphinx apidoc generation skeleton
change cherry picked from python module template commit 71b117ba0cf9f1251b1cac26d0994df03a4c787d
b53f5d8c · Stefano Zacchiroli · 8aa5c3aa · b53f5d8c · b53f5d8c · b53f5d8c
Commit b53f5d8c authored 7 years ago by Stefano Zacchiroli
--- a/docs/.gitignore
+++ b/docs/.gitignore
+_build/
+apidoc/
+*-stamp
--- a/docs/Makefile
+++ b/docs/Makefile
+include ../../swh-docs/Makefile.sphinx
--- a/docs/_static/.placeholder
+++ b/docs/_static/.placeholder
--- a/docs/_templates/.placeholder
+++ b/docs/_templates/.placeholder
--- a/docs/conf.py
+++ b/docs/conf.py
+from swh.docs.sphinx.conf import *  # NoQA
--- a/docs/index.rst
+++ b/docs/index.rst
+Software Heritage - Development Documentation
+=============================================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+
+
+Indices and tables
+==================
+
+* :ref:`genindex`
+* :ref:`modindex`
+* :ref:`search`