Допустим, исходная документация для класса выглядит так:
/**
* My custom class
*
* This class helps you do stuff. It's really great.
*
* @author David Smith
* @version 1.0
*/
Если я приду и переделаю 50% кода, как мне документально подтвердить, что я внес существенный вклад?
Как лучше добавить дату? например Когда последний раз изменялся код, когда я делал обновления или когда обновлялась версия.
Я знаю, что на самом деле не отвечаю на ваш вопрос, но мне интересно, почему вы вообще используете @author.
Для отслеживания изменений в коде (кто создал файл? кто изменил его?) используйте вашу систему контроля версий. Ведь для этого он и нужен :)
Один из способов, который я видел в компаниях, в которых я работал на протяжении многих лет, заключается в следующем:
/**
* My custom class
*
* This class helps you do stuff. It's really great.
*
* @author David Smith
* @version 1.0
*
* @modifier Rahul Parkar
* @modifiedDate 09/11/2012
*/
Кроме того, я видел, как они используют 2 метода для документирования изменений: один — использовать что-то вроде Git, где каждый коммит имеет сообщение о коммите, другой — использовать другой тег Doc для документирования изменений.
