[docs] [issue7447] Sum() doc and behavior mismatch

Alexander Belopolsky report at bugs.python.org
Mon Jul 26 00:52:59 CEST 2010


Alexander Belopolsky <belopolsky at users.sourceforge.net> added the comment:

FWIW, I like the new patch better, but still have a few nitpicks:

- Starting a sentence with an argument name is a bit awkward because that makes a sentence that starts with a lower case letter.  

- There is an extra space in :class: `list`.

- It would make more boring prose, but I would prefer to see similar language used in each alternative.  I.e.

   - To concatenate ...
   - To concatenate ...
   - To add ...

- Why "an *iterable* of iterables" but "a *sequence* of strings"?

- I am not sure it is correct to say "to concatenate an iterable", I think it should be "to concatenate items from an iterable."

----------

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


More information about the docs mailing list