[docs] Adds sphinx extensions

Note that for `sphinx-apidoc` to work we need a `__init__.py` file on
the `sagittal_average` library. Add it if not done
before. Alternatively you can pass the `--implicit-namespaces` flag to
`sphinx-apidoc` if you prefer to have a native namespace package.

Steps to build the docs
```bash
sphinx-apidoc -o ./docs/api ./src/sagittal_average
cd docs
make html # Assuming the library is installed
python -m http.server -d _build/html # to view the automatically built documentation
```

Author: dpshelio

docs/conf.py

@@ -14,7 +14,12 @@
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
-extensions = []
+extensions = [
+    'sphinx.ext.autodoc',  # Support automatic documentation
+    'sphinx.ext.coverage', # Automatically check if functions are documented
+    'sphinx.ext.mathjax',  # Allow support for algebra
+    'sphinx.ext.viewcode', # Include the source code in documentation
+]
 
 templates_path = ['_templates']
 exclude_patterns = ['_build', 'Thumbs.db', '.DS_Store']

docs/index.rst

@@ -10,3 +10,4 @@ Welcome to sagittal-average's documentation!
    :maxdepth: 2
    :caption: Contents:
 
+   API <api/modules>