uses definitions and adds phpdoc commenting