PHPDoc Improvements

In light of #8538, I decided to review all PHPDoc there is. It's pretty basic stuff, making sure `@param`s have both type and variable name and such.

So far I've gone through `/lib` - I'm going to hit `/apps` and everything else tomorrow.