Increased verbosity in phpdocs.

@amitaibu I was reading the code this morning and started fixing some PHPStorm warnings. That rapidly became a PR being more verbose in phpdocs.

Not a very useful PR, but I just started reading the stuff :stuck_out_tongue: