How to convert (unicode) text to image?
Thomas Jollans
thomas at jollybox.de
Mon Aug 30 06:50:32 EDT 2010
On Monday 30 August 2010, it occurred to rurpy at yahoo.com to exclaim:
> Face the facts dude. The Python docs have some major problems.
> They were pretty good when Python was a new, cool, project used
> by a handful of geeks. They are good relative to the "average"
> (whatever that is) open source project -- but that bar is so low
> as to be a string lying on the ground.
Actually, the Python standard library reference manual is excellent. At least
that's my opinion.
Granted, it's not necessarily the best in the world. It could probably be
better. But that goes for just about every documentation effort there is.
What exactly are you comparing the Python docs to, I wonder? Obviously not
something like Vala, but that goes without saying. "kj" said that the Perl
docs were better. I can't comment on that. I also won't comment on the sorry
mess that the language "Perl" is, either.
There are a few documentation efforts that I recognize are actually better
than the Python docs: Firstly, the MSDN Library docs for the .Net framework.
Not that I refer to it much, but it is excellent, and it probably was a pretty
darn expensive project too. Secondly, the libc development manual pages on
Linux and the BSDs. Provided you know your way around the C library, they are
really a top-notch reference.
If you were comparing it to the Java standard library documentation, please
provide a link. I've tried and failed to find any coherent documentation of
the standard classpath that anything like approaches the quality of the Python
documentation.
>
> Your overly defensive and oppressive response does not help.
> All it (combined with similar knee-jerk responses) does is
> act to suppress any criticism leaving the impression that
> the Python docs are really great, an assertion commonly made
> here and often left unchallenged. Responses like yours
> create a force that works to maintain the status quo.
More information about the Python-list
mailing list