add additional comments, PHPdoc and check whether it's really applicable