After first pre-commit processing

1 files changed, 38 insertions, 0 deletions

diff --git a/docs/howto.rst b/docs/howto.rst
new file mode 100644
index 0000000..73953de
--- /dev/null
+++ b/docs/howto.rst
@@ -0,0 +1,38 @@
+How To - Project Documentation
+======================================================================
+
+Get Started
+----------------------------------------------------------------------
+
+Documentation can be written as rst files in `pyblackbird_cc/docs`.
+
+
+To build and serve docs, use the commands::
+
+    docker compose -f local.yml up docs
+
+
+
+Changes to files in `docs/_source` will be picked up and reloaded automatically.
+
+`Sphinx <https://www.sphinx-doc.org/>`_ is the tool used to build documentation.
+
+Docstrings to Documentation
+----------------------------------------------------------------------
+
+The sphinx extension `apidoc <https://www.sphinx-doc.org/en/master/man/sphinx-apidoc.html>`_ is used to automatically document code using signatures and docstrings.
+
+Numpy or Google style docstrings will be picked up from project files and available for documentation. See the `Napoleon <https://sphinxcontrib-napoleon.readthedocs.io/en/latest/>`_ extension for details.
+
+For an in-use example, see the `page source <_sources/users.rst.txt>`_ for :ref:`users`.
+
+To compile all docstrings automatically into documentation source files, use the command:
+    ::
+
+        make apidocs
+
+
+This can be done in the docker container:
+    ::
+
+        docker run --rm docs make apidocs