The .deb contains no documentation, other than those in the python
source code's docstrings, which are fine for interactive use in the
python CLI but not really browsable.

I experimentally ran python-pydoctor on ipaddr.py and it seemed to
generate something plausible.  Perhaps you could consider doing the
same in the package.

If you think this is a good idea more generally, maybe there should be
some debhelper support for doing this.  Feel free to say that you want
this done only if done by debhelper or a plugin for debhelper; in
which case please reassign this bug.

Thanks,
Ian.

Reassigning to dh-python.  Since this is python specific, I think it would suit
better as an option in pybuild.

Scott K