General comments on the documentation pages, ala PHP.net
would be very valuable. It doesn't matter so much that old
comments hang around, as long as the date is marked.
I've had to work with PHP and found that the comments for each
api function were extremely valuable. I know non-technical
people who have built systems in PHP and explicitly stated that
the user comments were _the_ most important part of PHP.net,
in terms of getting their project finished.
If anything, it saves a bboard search, or looking through a
separate piece of documentation.