[Python-ideas] The non-obvious nature of str.join (was Re: sum(...) limitation)

[Terry Reedy]

On 8/11/2014 3:13 PM, Andrew Barnert wrote:

> Beginning programmers don't even know to look for a join function,

The rather complete index, where they will find it as a 
bytearray/bytes/str functions, as well as variations of thread.join.

> But someone coming to
> Python looking for the equivalent of -[NSArray
> componentsJoinedBySeparator:] or Enumerable#join or
> Sequence.joinStrings or whatever expects to find it as list.join.

When they don't find it, there is the index.

The first thing people should learn is that the Python doc set includes 
a tutorial for beginners, a Reference manual for syntax, a Library 
manual for objects, and a collective Index for all of these.  The Index 
starts with a Symbol page for looking up thing like '*' or '|=' that do 
not work in search engines.

-- 
Terry Jan Reedy