docs: final touches to structure of API

Author: oesteban

docs/Makefile

@@ -52,6 +52,7 @@ help:
 clean:
 	rm -rf $(BUILDDIR)/*
 	rm -rf reference/*
+	rm -rf api/*
 
 html:
 	PYTHONPATH=$(PYTHONPATH) $(SPHINXBUILD) -b html $(ALLSPHINXOPTS) $(BUILDDIR)/html

docs/api.rst

@@ -0,0 +1,9 @@
+Library API (application program interface)
+===========================================
+
+Information on specific functions, classes, and methods.
+
+.. toctree::
+
+   api/templateflow.api
+   api/templateflow.conf

docs/conf.py

@@ -88,7 +88,9 @@
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.
 # This pattern also affects html_static_path and html_extra_path.
-exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store', 'api/modules.rst']
+exclude_patterns = [
+    '_build', 'Thumbs.db', '.DS_Store',
+    'api/modules.rst', 'api/templateflow.rst']
 
 # The name of the Pygments (syntax highlighting) style to use.
 pygments_style = None

docs/index.rst

@@ -11,7 +11,7 @@ Contents
 
     naming
     tutorials
-    api/templateflow
+    api
 
 What's new
 ----------