transitioning to PHPDOC comments