Python documentation too difficult for beginners

Martin P. Hellwig martin.hellwig at
Tue Nov 2 12:52:07 CET 2010

On 11/02/10 10:42, jk wrote:
> Is there much chance that the Python maintainers will change their
> documentation system to make it more like Java or PHP? How would I go
> about trying to make that happen?
I am by no means an authority however since you ask it here I feel 
compelled to give you my opinion :-)

In general I would think that more documentation is always welcome, if 
you feel like you can make a contribution, excellent, please do!

However, I found that the documentation available was enough for me, and 
I didn't even have to go to the googles for that.

Typing help(thing_i_want_info_of) in the interpreter gives me precise 
consistent information for what I need to do with whatever it is I am 
doing and yes that is largely a replication of what is mentioned on the 
site itself (well more the other way around actually).

In the odd cases this doesn't help me, I google for examples.
If that doesn't help I look at the modules __file__ and open that module 
to read the source.

And when I started 10 odd years ago with Python it was my first language 
with no prior confusion of other languages, since then I extended my 
knowledge with C and assembler but on a day to day basis I still use Python.


More information about the Python-list mailing list