Message 164788 - 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.

Author	chris.jerdonek
Recipients	chris.jerdonek, ezio.melotti
Date	2012-07-07.06:03:48
SpamBayes Score	-1.0
Marked as misclassified	Yes
Message-id	<1341641029.42.0.551889407429.issue15270@psf.upfronthosting.co.za>
In-reply-to

Content
The "Economy of Expression" section of the Dev Guide's "Documenting Python"-- http://docs.python.org/devguide/documenting.html#economy-of-expression says, "The documentation for super() is an example of where a good deal of information was condensed into a few short paragraphs." However, the documentation for super() is now nine short paragraphs. Back in Python 2.2 (when super() was introduced), the description really was only two short paragraphs (along with a brief code snippet): http://docs.python.org/release/2.2.3/lib/built-in-funcs.html So this might no longer be the best example.

The "Economy of Expression" section of the Dev Guide's "Documenting Python"--

http://docs.python.org/devguide/documenting.html#economy-of-expression

says, "The documentation for super() is an example of where a good deal of information was condensed into a few short paragraphs."

However, the documentation for super() is now nine short paragraphs.  Back in Python 2.2 (when super() was introduced), the description really was only two short paragraphs (along with a brief code snippet):

http://docs.python.org/release/2.2.3/lib/built-in-funcs.html

So this might no longer be the best example.

History
Date	User	Action	Args
2012-07-07 06:03:49	chris.jerdonek	set	recipients: + chris.jerdonek, ezio.melotti
2012-07-07 06:03:49	chris.jerdonek	set	messageid: <1341641029.42.0.551889407429.issue15270@psf.upfronthosting.co.za>
2012-07-07 06:03:48	chris.jerdonek	link	issue15270 messages
2012-07-07 06:03:48	chris.jerdonek	create