[issue28499] Logging module documentation needs a rework.

Vinay Sajip added the comment: Closing, as no objections raised. -- resolution: -> not a bug stage: needs patch -> resolved status: open -> closed ___ Python tracker ___

[issue28499] Logging module documentation needs a rework.

Vinay Sajip added the comment: As there's (AFAIK) been no progress on this, I'd like to close this issue. Any objections? -- ___ Python tracker ___ __

[issue28499] Logging module documentation needs a rework.

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 "committing" :) 2016-11-02 13

[issue28499] Logging module documentation needs a rework.

Florian Strzelecki added the comment: A project published on RTD looks like a very good idea. I'll give it a try! Thanks for your feedback. I think we don't have the same opinion on how to organize parts and details, so it's on me to show something worth our times. > you seem to find the Djang

[issue28499] Logging module documentation needs a rework.

Vinay Sajip added the comment: I'm not sure this issue tracker is the best place to have an extended discussion about documentation - perhaps we should move this to a mailing list such as python-list. I'm not sure what you read first, but the logging documentation main page has a box marked "

[issue28499] Logging module documentation needs a rework.

Florian Strzelecki added the comment: Hi! Sorry for the delay. I published my slides on speaker deck: https://speakerdeck.com/exirel/read-and-write-the-doc It contains only my main ideas and key concepts, since I prefer to talk more than just read slides to the public. I hope Pycon FR's organi

[issue28499] Logging module documentation needs a rework.

Vinay Sajip added the comment: s/leaving the details/leaving the more narrative aspects/ -- ___ Python tracker ___ ___ Python-bugs-lis

[issue28499] Logging module documentation needs a rework.

Vinay Sajip added the comment: The current documentation makes it very simple for naive users, with the main section being a reference and leaving the details to the basic and advanced tutorials and the cookbook. This was deliberately done in response to earlier feedback that the documentation

[issue28499] Logging module documentation needs a rework.

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 must to fin

[issue28499] Logging module documentation needs a rework.

Changes by Ned Deily : -- nosy: +vinay.sajip ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: https://mail.pytho

[issue28499] Logging module documentation needs a rework.

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 ask us (the

[issue28499] Logging module documentation needs a rework.

Stéphane Wirtel added the comment: Hi Pierre, Thank you for your issue and mainly for me ;-) Now, I am really interested by your feedback or the feedback of Florian Strzelecki because he can give us the organization of the sections and maybe we can try to improve the current documentation of