Categories
Software and Programming

Reference Like It Oughta Be

Grrr. “Python”:http://www.python.org seems to have lots of useful libraries and services, for example codecs for translating between character sets / encodings, or an “HTML parser”:http://www.python.org/doc/current/lib/module-htmllib.html (well, actually there are “two”:http://www.python.org/doc/current/lib/module-HTMLParser.html – probably because the first one was too complicated).

And while this is all throughly documented, the documentation is mostly pretty confusing, because examples are thin on the ground.

So let me use this moment of frustration to point out why I think “Netscape’s Javascript Documentation”:http://devedge.netscape.com/central/javascript/ is simply *world-class*: it gives examples for everything. Practically every method of every object mentioned in it’s “client-side reference guide”:http://devedge.netscape.com/library/manuals/2000/javascript/1.3/guide/, for example, has sample code showing how the object or method can be created and used, and what the expected behaviour would be.

Which is probably why I’ll happily consider doing somthing in Javascript, but haven’t gotten deeper into Python than the simplest three-line script.