we've implemented a lot of logic in our docstring linter (chromite/cli/cros/lint.py) because there have been no open source alternatives.  however in the last few months, a project has started that we might be able to work with:
  https://github.com/terrencepreilly/darglint

we should figure out if we could merge all our docstring checks into that, and how we'd be able to hook it into our existing pylint checks.