[docs] [issue15439] Include Misc/ACKS names into the documentation

Ezio Melotti report at bugs.python.org
Wed Jul 25 18:29:39 CEST 2012

Ezio Melotti <ezio.melotti at gmail.com> added the comment:

FWIW including Misc/ACKS in the doc will probably break the generation of the pdf version of the doc, since it contains non-latin1 characters (see msg166408).  I don't think it's necessary to include the names in the doc.

> I don't know how Doc ACKS is maintained, but I think the devguide is
> fine as it stands, whether or not Doc ACKS is preserved or not. 
> People should put themselves into Misc/ACKS if they made a 
> contribution, period.

In my experience Doc/ACKS.txt is mostly ignored/unmaintained.  I did a lot of work on the docs and my name is not in there, and I don't think I ever added anyone there.

> If people need to be acknowledged separately for contributing to the
> documentation, I think only major contributions (such as writing the 
> documentation for a yet-undocumented module) should be explicitly 
> acknowledged.

It's already possible to give credit directly in the docs using directives like "sectionauthor".


Python tracker <report at bugs.python.org>

More information about the docs mailing list