Do you feel bad because of the Python docs?

Antoine Pitrou solipsis at pitrou.net
Wed Feb 27 14:17:13 CET 2013


Steven D'Aprano <steve+comp.lang.python <at> pearwood.info> writes:
> 
> It is valuable to contrast and compare the PHP and Python docs:
> 
> http://php.net/manual/en/index.php
> http://www.python.org/doc/

I suppose you should compare it with http://docs.python.org/3/ instead.

> There's no doubt that one of PHP's strengths, perhaps its biggest 
> strength, is the good state of documentation.

My (probably outdated) experience with the PHP docs is that they are very
succinct and don't document failure cases or behavioral details at all.
Sure, if you only care about the big picture, they are good enough.

Regards

Antoine.





More information about the Python-list mailing list