如何在java类注释中设置作者？

Question

对于我们的内部开发,将java类的作者写入类注释是很常见的.

它将以.的形式写成

* @author Doe, John (john.doe@example.com)

所有作者都将以此形式列出,在本课程中做得最多的人将首先列出.

我的问题:你如何处理这样的要求？您是在评论中设置作者身份还是使用源存储库来跟踪此信息？写作者姓名和电子邮件的最佳格式是什么？

Answer 1

您的源代码控制具有关于谁在课程中执行什么操作和何时执行的最正确信息.它是唯一可靠的信息来源(除非多个用户共享相同的用户/密码).

我通常不关心@author标签,大多数时候IDE会在创建类时自动插入标签.根据需要使用它,并选择所需的格式.

顺便说一句,谁做的工作更多？编写整个类代码的人,或者在调查两周后更改一行代码以修复生产错误的人？