[docs] [issue37557] Example snippets for simpler functions/methods

Raymond Hettinger report at bugs.python.org
Sat Jul 13 02:03:42 EDT 2019

Raymond Hettinger <raymond.hettinger at gmail.com> added the comment:

We generally only put the examples where they add something substantive.  Otherwise, it just make the docs verbose and time consuming to read start to finish.

Adding an example for str.lower() contributes no additional value.  Most published Python books would all avoid the unnecessary here as well.  FWIW, we have no evidence that any user has ever found the current form hard to use.

So, let's close this.  If you're looking for places to contribute, please look at the open bugs where there are known problems.

nosy: +rhettinger
resolution:  -> rejected
stage:  -> resolved
status: open -> closed

Python tracker <report at bugs.python.org>

More information about the docs mailing list