PHP documentation is one of the worst things I've ever seen. That people subject themselves to abuse such as "reading it" is comical to me. Enjoy scrolling down 15 years of comments to get the quick rundown.
I agree that the comments should be removed or at least hidden by default as they're usually not relevant anymore.