when to update the tag @author in PHPdoc?
This is really a newbie question.
I'm trying to improve my skills with PHP, so I'm reading the code of some libraries. I noticed that many PHPdoc headers (is this the right name? I mean this:
/**
* @param $config
* @return bool
* @author developer1
*/
) contain the @author tag.
Let's say that developer2 makes huge changes to developer1's function and then commits to github. Should developer2 update the @author tag?
What's the common practice?
phpDocumentor 2 support multiple @author tags:
/**
* Class User
* @author Styx
* @author second author
* @package ApplicationModel
*/
class User
{
}
http://www.phpdoc.org/docs/latest/references/phpdoc/tags/author.html
链接地址: http://www.djcxy.com/p/82458.html