Module docstrings #8
Description
Pep257 discusses documenting functions, classes and other objects exported from a module should be documented in the module docstring. Add a linter that checks this:
# module.py
"""...
Functions:
foo: ...
Classes:
FooClass: ...
Constants:
FOO: ...
"""
FOO = ...
def foo(): ...
class FooClass: ...