Merge branch 'f-how-to-doc' into 'dev'

how to doc

See merge request !68

src/doc/README_SETUP.md

@@ -70,6 +70,8 @@ pip3 install --user .
 ## Run Unit Tests
 
 ## Documentation ##
+We use sphinx to create the documentation. Docstrings in the code should comply
+with the Googly style (see link below).
 
 Build documentation in `src/doc` with `make html`.
 
@@ -79,4 +81,10 @@ Build documentation in `src/doc` with `make html`.
 - `sphinx-autoapi`
 - `recommonmark`
 
-### Troubleshooting ###
+### How to contribute ###
+
+- [Google Style Python Docstrings](https://sphinxcontrib-napoleon.readthedocs.io/en/latest/example_google.html)
+- [Google Style Python Docstrings 2nd reference](https://github.com/google/styleguide/blob/gh-pages/pyguide.md#38-comments-and-docstrings)
+- [References to other documentation](https://www.sphinx-doc.org/en/master/usage/extensions/intersphinx.html#role-external)
+
+