Python documentation too difficult for beginners

[Kee Nethery]

On Nov 2, 2010, at 11:07 AM, Ian wrote:

> On 02/11/2010 14:47, jk wrote:
>> I think the key difference is that I don't want to have to *read*
>>  the
>> python docs - I want to be able to scan for what I'm looking for and
>> find it easily. That makes me productive.
>> 
> Hi jk, 
> 
> I totally agree. But you will get nowhere. 
> 
> A few weeks back I complained that 
> http://docs.python.org/reference/executionmodel.html#naming-and-binding
> was more than a little opaque - and was not understood by Python noobs such as myself. 
> 
> I was invited to rewrite it and submit an improved version.  

In this world of moderated wikis one would think that noobs such as myself could enhance the docs when we find something confusing in the docs. <insert snarky comment here>

Kee