Message198985
Improving documentation is a fine aim. However, finding the correct balance between reference, tuition and precis (i.e. overview) is tricky.
I would like to see more documentation laid out with the code and tests. This at least binds the examples with running code.
I am sure this has been asked already, but has anyone done an analysis of the web-server log for the documentation sites ? |
|
Date |
User |
Action |
Args |
2013-10-05 11:58:54 | CliffM | set | recipients:
+ CliffM, rhettinger, techtonik, ezio.melotti, docs@python, tshepang |
2013-10-05 11:58:54 | CliffM | set | messageid: <1380974334.44.0.503618374545.issue19121@psf.upfronthosting.co.za> |
2013-10-05 11:58:54 | CliffM | link | issue19121 messages |
2013-10-05 11:58:54 | CliffM | create | |
|