Ian Bicking: the old part of his blog

Towards php comment 000

About the documentation

Agreed, agreed, agreed. It's one of the thing which really needs improvement at the python Web site. The documentation is just not usable for people with little understanding of programming. The step is really too high to be able to start programming because of the documentation.

Take for example Module Email in Python http://docs.python.org/lib/module-email.html

And compare to Module Mail in PHP http://jp2.php.net/manual/function.mail.php

What is more useful for a beginner? Attracting more beginners to Python will help to reach the mass limit for having a python ecology on Web sites. :) Documentation is one of the key thing.

Better doc, more people more people, progress in libraries and hosting services supporting python.

I love python, but it's very difficult to use at the start.

Comment on Re: Towards PHP
by karl