[New-bugs-announce] [issue15270] "Economy of Expression" section outdated

[Chris Jerdonek]

New submission from Chris Jerdonek <chris.jerdonek at gmail.com>:

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.

----------
components: Devguide
keywords: easy
messages: 164788
nosy: cjerdonek, ezio.melotti
priority: normal
severity: normal
status: open
title: "Economy of Expression" section outdated
versions: Python 3.3

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