I often take over maintenance for sites that have been deserted by their original programmers, and usually when one of these web geniuses spontaneously combusts he burns with him all documentation.
He hits the nail on the head when it comes to comments you find in already developed code:
And vents his frustration about the overuse of libraries:
The sad thing about it is that Eike is not alone, the main difference is that he bothers to tell the world about these frustrations. These are the people we should be listening to when we develop libraries or write documentation as most of what gets produced these days will go through the hands of developers like Eike. It is not at all about how cool your script is or what new trick you found, it is about how much of a mess you leave behind when you leave it to someone else to maintain.
This will also be the biggest topic of my talk at @media Ajax and I am happy to have found this post.