Javadoc @author tag good practices

后端 未结 7 734
天命终不由人
天命终不由人 2020-12-02 20:18

I\'m wondering about best practices when creating Javadocs. I have a project with many files. Code has been created by many developers. Each file has an annotation @au

7条回答
  •  醉酒成梦
    2020-12-02 20:28

    You may want to consider why you want author tags in the source. The Apache Foundation do not and I agree.

    http://www.theinquirer.net/inquirer/news/1037207/apache-enforces-the-removal-of-author-tags

    To my best understanding this is a cargo cult way of working from when sources were printed on paper. With modern version control systems this information and more can be found in the history anyway.

提交回复
热议问题