Message 145318 - Python tracker

➜

This issue tracker has been migrated to GitHub , and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

In-reply-to
Author	ncoghlan
Recipients	Kyle.Simpson, docs@python, eric.araujo, ezio.melotti, ncoghlan, terry.reedy
Date	2011年10月11日.00:45:35
SpamBayes Score	4.1841595e-05
Marked as misclassified	No
Message-id	<1318293936.12.0.82328975529.issue12602@psf.upfronthosting.co.za>

Content
Don't feel bad about not recognising the context - this stuff wasn't documented at all for a long time, and it wasn't until Georg pointed me to the usage docs that I realised adding it there would be the right place. I should have remembered that and been less cryptic when creating this issue. It may suggest a meta-issue though - perhaps 'Documenting Python' should grow a devguide-style description of the Docs layout in source control, with a pointer from the devguide's directory layout description [1]? [1] http://docs.python.org/devguide/setup.html#directory-structure

Content

Don't feel bad about not recognising the context - this stuff wasn't documented at all for a long time, and it wasn't until Georg pointed me to the usage docs that I realised adding it there would be the right place. I should have remembered that and been less cryptic when creating this issue.
It may suggest a meta-issue though - perhaps 'Documenting Python' should grow a devguide-style description of the Docs layout in source control, with a pointer from the devguide's directory layout description [1]?
[1] http://docs.python.org/devguide/setup.html#directory-structure

History
Date	User	Action	Args
2011年10月11日 00:45:36	ncoghlan	set	recipients: + ncoghlan, terry.reedy, ezio.melotti, eric.araujo, docs@python, Kyle.Simpson
2011年10月11日 00:45:36	ncoghlan	set	messageid: <1318293936.12.0.82328975529.issue12602@psf.upfronthosting.co.za>
2011年10月11日 00:45:35	ncoghlan	link	issue12602 messages
2011年10月11日 00:45:35	ncoghlan	create

homepage