summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/source/docs/howto_document.rst7
1 files changed, 7 insertions, 0 deletions
diff --git a/doc/source/docs/howto_document.rst b/doc/source/docs/howto_document.rst
index 2a97a100d..cf86b7e99 100644
--- a/doc/source/docs/howto_document.rst
+++ b/doc/source/docs/howto_document.rst
@@ -4,6 +4,13 @@
A Guide to NumPy/SciPy Documentation
====================================
+User documentation
+*******************
+NumPy text documents should follow the `Google developer documentation style guide <https://developers.google.com/style>`_.
+
+Docstrings
+**********
+
When using `Sphinx <http://www.sphinx-doc.org/>`__ in combination with the
numpy conventions, you should use the ``numpydoc`` extension so that your
docstrings will be handled correctly. For example, Sphinx will extract the