Starting with the 4.0 release of pydocstyle, the tool supports the Google/Napoleon docstring convention that we use for Software Heritage development (the pydocstyle documentation isn't yet fully consistent in saying it does, but yes, it really does !).

To use it:

$ pip3 install pydocstyle
$ pydocstyle --convention=google foo.py

We should lint all our docstrings with pydocstyle (and yes, reaching 0 warnings/errors it's gonna take a while…).