PHPdoc में टैग @Author को अपडेट करने के लिए कब?

Question

यह वास्तव में एक नौसिखिया सवाल है।

मैं PHP के साथ अपने कौशल में सुधार करने की कोशिश कर रहा हूं, इसलिए मैं कुछ पुस्तकालयों का कोड पढ़ रहा हूं। मैंने देखा है कि कई phpdoc हेडर (यह सही नाम है मैं इसका मतलब यह:

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

) @author टैग होते हैं।

मान लें कि डेवलपर 2 डेवलपर 1 के फ़ंक्शन में बड़े बदलाव करता है और फिर जिथब में जाता है। डेवलपर 2 को @Author टैग अपडेट करना चाहिए?

सामान्य अभ्यास क्या है?

Answer 1

phpDocumentor 2 समर्थन कई @author टैग: - phpdoc एक नहीं पड़ा है

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

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