Better PHPDocBlock

Example of a better docblock