improved PHPDocs