Author ncoghlan
Recipients docs@python, josh.r, ncoghlan, rhettinger, serhiy.storchaka, vy0123, xiang.zhang
Date 2017-04-09.09:55:54
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1491731754.68.0.394817666882.issue22702@psf.upfronthosting.co.za>
In-reply-to
Content
Raymond, in the review comments on https://github.com/python/cpython/pull/156 Xiang noted that the current apparently duplicated iterable isn't entirely redundant:

- the first reference is to the term "iterable"
- the second reference is to the parameter name "*iterable*"

"Return a string which is the concatenation of the strings in the :term:`iterable` *iterable*."

So if we're going to drop one of them, it should probably be the link to the term, rather than the parameter name:


"Return a string which is the concatenation of the strings in *iterable*."

Does that sound reasonable to you?
History
Date User Action Args
2017-04-09 09:55:54ncoghlansetrecipients: + ncoghlan, rhettinger, docs@python, serhiy.storchaka, josh.r, vy0123, xiang.zhang
2017-04-09 09:55:54ncoghlansetmessageid: <1491731754.68.0.394817666882.issue22702@psf.upfronthosting.co.za>
2017-04-09 09:55:54ncoghlanlinkissue22702 messages
2017-04-09 09:55:54ncoghlancreate