[docs] [issue19121] Documentation guidelines enhancements

[CliffM]

CliffM added the comment:

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 ?

----------
nosy: +CliffM

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue19121>
_______________________________________