[docs] [issue18576] Document test.support.script_helper

Christie report at bugs.python.org
Sun Jun 7 20:25:29 CEST 2015


Christie added the comment:

> If you diffed your patch from a public revision in the main repository, there should be a nice “Review” link.

Ah, thanks @vadmium!!! I've been confused about why some patches get review links and others do not >.<

I'll have a new patch up shortly which is diffed against a public revision and has your suggested changes.

> For autodoc in particular, we prefer to avoid it for the main docs because "good docstring" and "good prose documentation" don't necessarily look alike. 

@ncoghlan for some reason I thought that the main docs were also auto generated from docstrings in the actual modules, but I can see now that that isn't the case.

I'll reach out to docs at python.org to see how they feel about autogenerating the test.support docs.

----------

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


More information about the docs mailing list