Message 170600 - 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	pitrou
Recipients	aliles, asvetlov, brett.cannon, chris.jerdonek, docs@python, eli.bendersky, eric.araujo, ezio.melotti, georg.brandl, pitrou, r.david.murray, sbt, terry.reedy, v+python
Date	2012年09月17日.12:30:49
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1347885050.5.0.0338961722505.issue15629@psf.upfronthosting.co.za>

Content
I think I'm -1 to run doctests as part of regrtest. Documentation examples are meant to be read, not executed: it is fine for them to omit unimportant information or trivial boilerplate (such as imports). Any complication in the way doc examples must be written will deter us from actually writing examples. Furthermore, spreading unit tests in the doc files instead of Lib/test files will make maintenance of tests more tedious as well.

Content

I think I'm -1 to run doctests as part of regrtest. Documentation examples are meant to be read, not executed: it is fine for them to omit unimportant information or trivial boilerplate (such as imports).
Any complication in the way doc examples must be written will deter us from actually writing examples.
Furthermore, spreading unit tests in the doc files instead of Lib/test files will make maintenance of tests more tedious as well.

History
Date	User	Action	Args
2012年09月17日 12:30:50	pitrou	set	recipients: + pitrou, brett.cannon, georg.brandl, terry.reedy, ezio.melotti, eric.araujo, v+python, r.david.murray, eli.bendersky, asvetlov, chris.jerdonek, docs@python, sbt, aliles
2012年09月17日 12:30:50	pitrou	set	messageid: <1347885050.5.0.0338961722505.issue15629@psf.upfronthosting.co.za>
2012年09月17日 12:30:50	pitrou	link	issue15629 messages
2012年09月17日 12:30:49	pitrou	create

homepage