Survey: improving the Python std lib docs
Marco Buttu
marco.buttu at gmail.com
Tue May 16 10:59:28 EDT 2017
On 15/05/2017 13:44, Ned Batchelder wrote:
> As it is, if I make a suggestion about the itertools docs (why do we need
> 20-line "equivalent to" Python code, and why don't we have any usage
> examples?), then I have to debate it with the developer of itertools,
> who has a different aesthetic and style than the developer of logging,
> or email, or re, and so on.
True story
> If we had one person who had the authority to make doc-wide decisions,
> then we might be able to move towards coherent guidelines for the docs
> to be more uniform.
That could be a solution :-)
--
Marco Buttu
INAF-Osservatorio Astronomico di Cagliari
Via della Scienza n. 5, 09047 Selargius (CA)
Phone: 070 711 80 217
Email: mbuttu at oa-cagliari.inaf.it
More information about the Python-list
mailing list