[issue12047] Expand the style guide

2011-05-10 Thread Raymond Hettinger
Changes by Raymond Hettinger : -- resolution: -> fixed status: open -> closed ___ Python tracker ___ ___ Python-bugs-list mailing lis

[issue12047] Expand the style guide

2011-05-10 Thread Roundup Robot
Roundup Robot added the comment: New changeset 50a5e271edf9 by Raymond Hettinger in branch '2.7': Issue 12047: Expand the style guide. http://hg.python.org/cpython/rev/50a5e271edf9 -- ___ Python tracker __

[issue12047] Expand the style guide

2011-05-10 Thread Roundup Robot
Roundup Robot added the comment: New changeset d5d91b14b238 by Raymond Hettinger in branch '3.2': Issue 12047: Expand the style guide. http://hg.python.org/cpython/rev/d5d91b14b238 -- nosy: +python-dev ___ Python tracker

[issue12047] Expand the style guide

2011-05-10 Thread Georg Brandl
Georg Brandl added the comment: And I sincerely hope we don't have any docs that say "if you don't know what this is, you don't need it" instead of an explanation :) -- ___ Python tracker

[issue12047] Expand the style guide

2011-05-10 Thread Raymond Hettinger
Raymond Hettinger added the comment: > there's a "talk down them" which looks funny to me in this word order. It was missing a word. Should be "talk down to them". Thanks for spotting this -- I fix it in the commit. > One question: I could imagine wording like > "this is rarely needed" ins

[issue12047] Expand the style guide

2011-05-09 Thread Georg Brandl
New submission from Georg Brandl : Sounds very good to me. One small thing: in the first para of "Audience", there's a "talk down them" which looks funny to me in this word order. One question: I could imagine wording like "this is rarely needed" instead of "this is experts only" -- would you

[issue12047] Expand the style guide

2011-05-09 Thread Raymond Hettinger
Changes by Raymond Hettinger : -- assignee: georg.brandl components: Documentation files: style.diff keywords: patch nosy: georg.brandl, rhettinger priority: normal severity: normal status: open title: Expand the style guide Added file: http://bugs.python.org/file21951/style.diff __