Here is a list of common gotchas when formatting Python docstrings for Sphinx and the Napoleon style.
TODO