[issue12047] Expand the style guide

[Raymond Hettinger]

Raymond Hettinger <raymond.hettinger at gmail.com> 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" instead of "this is experts only" 
> -- would you say it will be effective in making people
> think if they really want to do that?

Something along these lines would be a step in the right direction (though "rarely needed" is problematic if happens to match the readers need at the moment).  At this point, I would be happy just to get rid of the danger-experts-only remarks.  Just about any substitute would be better.

----------

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