diff --git a/source/python/docstrings.md b/source/python/docstrings.md index f8439ef..0268946 100644 --- a/source/python/docstrings.md +++ b/source/python/docstrings.md @@ -23,3 +23,16 @@ Sphinx](https://thomas-cokelaer.info/tutorials/sphinx/rest_syntax.html). - Google Python Style Guide: - Example Google Style Python Docstrings: https://www.sphinx-doc.org/en/master/usage/extensions/example_google.html + +## Napoleon and Sphinx + +### Docstring Sections + +The most comment docstring sections are: + +- `Args:` +- `Returns:` +- `Raises:` +- `Yields:` +- `See Also:` +- more see: [Docstring Sections](https://www.sphinx-doc.org/en/master/usage/extensions/napoleon.html#docstring-sections)