[issue15270] "Economy of Expression" section outdated

2012-09-23 Thread Raymond Hettinger
Raymond Hettinger added the comment: This whole discussion was inane. -- resolution: -> fixed status: open -> closed ___ Python tracker ___ _

[issue15270] "Economy of Expression" section outdated

2012-09-23 Thread Roundup Robot
Roundup Robot added the comment: New changeset 100909b4def0 by Raymond Hettinger in branch 'default': Issue #15270. Appease critics by removing a reference to the docs for super(). http://hg.python.org/devguide/rev/100909b4def0 -- nosy: +python-dev _

[issue15270] "Economy of Expression" section outdated

2012-09-23 Thread Ezio Melotti
Ezio Melotti added the comment: IMHO the paragraph about super() can be dropped altogether. -- ___ Python tracker ___ ___ Python-bugs-

[issue15270] "Economy of Expression" section outdated

2012-07-13 Thread Tshepang Lekhonkhobe
Changes by Tshepang Lekhonkhobe : -- nosy: +tshepang ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mai

[issue15270] "Economy of Expression" section outdated

2012-07-08 Thread Éric Araujo
Changes by Éric Araujo : -- nosy: +eric.araujo ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.pyth

[issue15270] "Economy of Expression" section outdated

2012-07-07 Thread Raymond Hettinger
Raymond Hettinger added the comment: The point was that the docs shouldn't "write a book" where briefer explanations suffice. The mention of super() may not be the best example because many "experts" still don't get what it is all about regardless of how much or how little much is written.

[issue15270] "Economy of Expression" section outdated

2012-07-07 Thread Antoine Pitrou
Antoine Pitrou added the comment: The super() doc is also a good example of unreadable jargon ("dynamic execution environment" ??). Nowhere is it obvious to a beginner what super() is *practically* used for. -- assignee: -> docs@python components: +Documentation nosy: +docs@python, p

[issue15270] "Economy of Expression" section outdated

2012-07-06 Thread Chris Jerdonek
New submission from Chris Jerdonek : 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