Survey: improving the Python std lib docs

[Marco Buttu]

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