update phpdoc and added links to github issues for todo comments