[issue28499] Logging module documentation needs a rework.

2016-11-02 Thread Pierre Bousquie
Pierre Bousquie added the comment: Thank you Vinay for your feedback. RTD seems a very good start to me. Florian thanks for joining :). I'm not leaving you alone on this! I don't mind closing the "bug" request. It was mainly for Stéphane Wirtel :)... but it's still &q

[issue28499] Logging module documentation needs a rework.

2016-10-22 Thread Pierre Bousquie
Pierre Bousquie added the comment: Hi stephane, I have tweeted Florian and he is still interested. I think the doc has a lot of information but does not organize it efficiently. My notes from the conference: - Logging reccord attribute is at 16.6.7 (middle of the doc) and that's a mus

[issue28499] Logging module documentation needs a rework.

2016-10-21 Thread Pierre Bousquie
New submission from Pierre Bousquie: At pyconf-fr 2016 Florian Strzelecki (@Exirel) made a great talk on how to make good documentation. At one time he asked "python logging doc?, did you realy found it clear and helpfull?" clear answer from the crowd: not at all. Stephane Wirtel a