PHPdoc Validation Improvements

Once our php doc validates successfully across the code base,
it would be good to start seeing us review and improve the content
Merge pull request #197 from grangeway/phpdoc2

PHPdoc Validation Improvements