4 ms·
> Use reST for docstrings I would suggest also using the Napoleon [1] extension now included with recent versions of Sphinx. It allows you to use Google or Num
by kevin_thibedeau 11y ago
> Use reST for docstrings
I would suggest also using the Napoleon [1] extension now included with recent versions of Sphinx. It allows you to use Google or Numpy-style reST formatting to describe parameters and types without all the javadoc-ish noise from :param:, :type:, and others.
[1] https://sphinxcontrib-napoleon.readthedocs.org/en/latest/ https://sphinxcontrib-napoleon.readthedocs.org/en/latest/
- pixelmonkey 11y agoThanks -- we are actually discussing this possible change in a Pull Request here: https://github.com/amontalenti/elements-of-python-style/pull/4 https://github.com/amontalenti/elements-of-python-style/pull...