是否需要作者标签？

Question

我能发现的唯一与此相关的其他问题是一个关于java doc author标签的问题。

我认为作者标签只是不必要的杂音，尤其是当如今大多数IDE可以轻松进行代码注释时。

但是，如果有一个或两个好的用例支持在文档中使用@author标签，我愿意改变主意。

Answer 1

不需要与文档块相关的任何内容。毕竟，它们只是评论。

许多项目都发布了编码标准，这些标准要求带有某些标签的docblock，但这仅仅是一个已达成共识的约定，只能通过同行评审来实施。如果您实际上需要带有某些标签的文档块，则需要使用PHPCS之类的工具，该工具可在预提交挂钩或管道构建步骤中运行。

关于作者标签，​​我发现它们几乎没有用，因为您的源代码控制系统将包含更多详细信息。我唯一使用它们的地方是在公共/共享项目中，我想为此付出功劳。