11
Trong hầu hết các nhóm, có một quy tắc cho biết rằng các từ khóa @author và @since phải được sử dụng cho tất cả các lớp được tài liệu, đôi khi thậm chí là các phương pháp.Việc quản lý mã nguồn có làm cho @author của Javadoc và @since thừa không?
Trong nỗ lực tập trung vào những gì quan trọng, tôi không sử dụng các từ khóa này và thay vào đó dựa vào thực tế là tôi có thể sử dụng hệ thống quản lý kiểm soát nguồn để xác định ai là tác giả của lớp và kể từ khi nào nó tồn tại.
Tôi tin rằng @author và @since đến từ thời điểm kiểm soát phiên bản chưa phổ biến và tôi nghĩ rằng chúng khá dư thừa ngay bây giờ. Bạn nghĩ thế nào về cái này? Nên các dự án Java hiện đại sử dụng chúng?
+1, tôi nghĩ rằng thẻ tác giả là vô ích. –
Tôi không đồng ý với đánh giá thẻ @Author chút nào - +1 – aperkins
Sao chép chỉ tốt cho dự phòng, như trong Mã sửa lỗi. – ninjalj