Updated docblocks with param and return values, and for WP core standards.

Updated formatting of existing PHPDocs to format them for current WP core standards, and added `@param` and `@return` values for methods that just had `[type]` placeholders.