Bug#894214: python-debian: Build API documentation

Stuart Prescott stuart at debian.org
Sun Apr 15 16:21:24 BST 2018


… And now merged, with API documentation now published automatically at

	https://python-debian-team.pages.debian.net/python-debian/


> > The autodoc API documentation needs to learn not
> > to pick up some private members that are uninteresting while we need to
> > keep others present since they are base classes and the only documentation
> > for some subclasses is within those base classes. The input of those with
> > more sphinx experience would be great about now!
> 
> This problem remains -- some "_hiddden" classes and functions need to be
> included in the API docs to be meaningful at all while others are most
> unwelcome.
> 
> Help needed!
> 
> > Is it worth putting these files into a new python-debian-doc binary
> > package?
> My feeling is that if the apidocs are useful enough to put on a website,
> they are useful enough to put in a package.

regards
Stuart

-- 
Stuart Prescott    http://www.nanonanonano.net/   stuart at nanonanonano.net
Debian Developer   http://www.debian.org/         stuart at debian.org
GPG fingerprint    90E2 D2C1 AD14 6A1B 7EBB 891D BBC1 7EBB 1396 F2F7



More information about the pkg-python-debian-maint mailing list