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