Author CliffM
Recipients CliffM, docs@python, ezio.melotti, rhettinger, techtonik, tshepang
Date 2013-10-05.11:58:54
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1380974334.44.0.503618374545.issue19121@psf.upfronthosting.co.za>
In-reply-to
Content
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 ?
History
Date User Action Args
2013-10-05 11:58:54CliffMsetrecipients: + CliffM, rhettinger, techtonik, ezio.melotti, docs@python, tshepang
2013-10-05 11:58:54CliffMsetmessageid: <1380974334.44.0.503618374545.issue19121@psf.upfronthosting.co.za>
2013-10-05 11:58:54CliffMlinkissue19121 messages
2013-10-05 11:58:54CliffMcreate