[
https://issues.apache.org/jira/browse/XALANJ-2672?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17739311#comment-17739311
]
Mukul Gandhi commented on XALANJ-2672:
--------------------------------------
@Gary, thanks for the thoughts about this topic. I shall delete my, author
references from the XalanJ dev branch xalan-j_xslt3.0 within due course.
> Suggestion: avoid adding @author tag to javadoc, or document its use
> --------------------------------------------------------------------
>
> Key: XALANJ-2672
> URL: https://issues.apache.org/jira/browse/XALANJ-2672
> Project: XalanJ2
> Issue Type: Improvement
> Security Level: No security risk; visible to anyone(Ordinary problems in
> Xalan projects. Anybody can view the issue.)
> Reporter: Vladimir Sitnikov
> Assignee: Gary D. Gregory
> Priority: Major
>
> {{@author}} tags are problematic since:
> * They can become stale, and it is hard to tell when they should be removed
> * It is hard to tell when a new author tag should be added
> See other samples in
> https://stackoverflow.com/a/17271433,
> https://github.com/junit-team/junit5/issues/914#issuecomment-328078934
> ---
> It is unclear if every contributor should add {{@author}} tag or not.
> It is unclear if {{@author}} tag should be removed in case the file is
> significantly modified.
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
