Éric Araujo <merwok@netwok.org> added the comment:
I worked on this some time ago; the problem was the size of the documentation, i.e. it was difficult to stay consistent. I think it’s okay to improve the docs one patch at a time, starting with the simple example referenced in the first message in this bug report, and gradually improving other sections. Do you have a diff with your work, so that your efforts can serve as a base for someone else?
Do I have time for this? Yes, but I wouldn't get it done anytime soon, and the results could be anywhere from good to bad. That’s why we do reviews :) It’s okay if you don’t have time, I’m interested in working on this some time in the future.
---------- assignee: docs@python -> eric.araujo _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue11176> _______________________________________