Hi all! There is a thread on the NumPy mailing list discussing a linter that pandas uses for numpydoc docstrings. It sounds super useful and I think we should adopt it. =) https://mail.python.org/pipermail/numpy-discussion/2019-July/079843.html https://mail.python.org/pipermail/numpy-discussion/2019-July/079843.html Gaël additionally proposes that this should be pushed to napoleon, a Sphinx now-built-in extension that supports the numpydoc standard. Perhaps we should move to napoleon also. Waiting to hear your thoughts, will propose a PR if people are on board. Juan.