improve phpdocs