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. =)

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.