Python-URL! - weekly Python news and links (Nov 17)

[Francesco Guerrieri]

On Mon, Nov 17, 2008 at 6:44 PM,  <rurpy at yahoo.com> wrote:
> On Nov 17, 8:54 am, "Gabriel Genellina" <python-... at phaseit.net>
> wrote:
>>     Candidate to *Longest and Most Boring Thread of the Year* - started
>>     more than a month ago, currently discussing "The official definition
>>     of call-by-value", and "What't the value of an object":
>>         http://groups.google.com/group/comp.lang.python/t/6163956596a8c082/
>
> Nice.  The Python Reference defines objects, the core concept
> of Python, as id, type, and value, and then leaves one clueless
> about what a value is, and several notable Python contributors
> declare the subject boring.
>
> I guess this goes a long way to explaining why the Python docs
> suck so badly in many areas.

This is a commonly heard assertion.
Maybe it's just me but I find that on average Python documentation on
the web is pretty good (*) and does its job very well.
One is also left to wonder why all these critics don't take some
initiative and work to improve it.

Francesco
(*) Not to mention many books, papers, and magazines, like those by
Alex Martelli, Mark Lutz, Mark Hammond and many others.