How do I document a module in Python?

Add your docstring as the first statement in the module.

"""
Your module's verbose yet thorough docstring.
"""

import foo

# ...

For packages, you can add your docstring to __init__.py.