I reeeeeealy dislike user comments on documentation. It's one of the
worst thing about PHP's documentation.

That said, if any of you follow me on Twitter, you'll have seen the
zillions of tweets I sent out today about this; I _do_ think that
Ruby's documentation needs a lot of work. I'm not sure that a huge,
heavy-handed process is the right way, though.