quando aggiornare il tag @author in PHPdoc?

Question

Questa è davvero una domanda da principianti.

Sto cercando di migliorare le mie competenze con PHP, quindi sto leggendo il codice di alcune librerie. Ho notato che molti intestazioni PHPDoc (è questo il nome giusto voglio dire questo:?

/** 
* @param $config 
* @return bool 
* @author developer1 
*/ 

) contengono il tag @author.

Diciamo che sviluppatore2 apporta enormi modifiche alla funzione dello sviluppatore1 e quindi si impegna a github. Lo sviluppatore2 dovrebbe aggiornare il tag @author?

Qual è la pratica comune?

Answer 1

phpDocumentor 2 di supporto più tag @Author:

/** 
* Class User 
* @author Styx 
* @author second author 
* @package Application\Model 
*/ 
class User 
{ 
} 

http://www.phpdoc.org/docs/latest/references/phpdoc/tags/author.html