Be Careful What You Promise

Posted on January 30, 2007

On May 30 of last year, I wrote a post titled "The Worst Thing About PHP" in which I decried the sorry organization of PHP’s documentation.

Many commenters said that the problem would soon be fixed, thanks to a new approach to documentation called "Livedocs":

Livedocs on the long run is also supposed to help you select just the extensions you need, and hide all others, so you can browse, search in and explore the functionality you are interested in. Cool isn’t it?

Philip Olson, a student who had been sponsored under Google’s Summer of Code project to work on Livedocs, also commented:

[D]on’t worry, Livedocs will be out before Vista and that’s a promise 😉

OK. Well, Windows Vista officially launched to consumers at midnight last night.  And how does the PHP documentation look this morning?

Sigh.