So moved, then. -- /_ Joe Kesselman (he/him/his) -/ _) My Alexa skill for New Music/New Sounds fans: / https://www.amazon.com/dp/B09WJ3H657/
() Plaintext Ribbon Campaign /\ Stamp out HTML mail! ________________________________ From: Gary Gregory <garydgreg...@gmail.com> Sent: Sunday, July 2, 2023 8:50:04 AM To: dev@xalan.apache.org <dev@xalan.apache.org> Subject: Re: Suggestion: avoid adding @author tag to javadoc In (requires login and proper rights) https://whimsy.apache.org/board/minutes/Confirming_that_the_current_stance_on__author_tags_as.html I quote the Apache Board minutes: "per Greg's email message of February is still appropriate (Recommend strongly that @author is avoided; but leave it to each PMC to make the final call with their respective communities.). This was confirmed." Well, the way I see it, nothing is required of us to happen, but I do not see why we would go against a STRONG recommendation. Gary On Sun, Jul 2, 2023, 08:40 Mukul Gandhi <muk...@apache.org<mailto:muk...@apache.org>> wrote: Hi Gary & all, On Sat, Jul 1, 2023 at 5:10 PM Gary Gregory <garydgreg...@gmail.com<mailto:garydgreg...@gmail.com>> wrote: > In general @author tags are discouraged Apache wide IIRC but I don't have a > URL for that. Over in the Commons project, we not only stopped using them, > but I've removed most of them. The tags are usually misleading because that's > usually never the only person who touched the file. You then get into games > about what the threshold for adding a name is, and that's a waste of time IMO. > > Instead, authors get credit in the pom.xml, and in changed.xml for each > action element which are used to generate release notes. And that's a much > better reflection of who did what. > > My suggestion is that we do the same in Xalan-J. I've just been analyzing earlier today, XalanJ codebase on dev branch xalan-j_xslt3.0, about presence of @author tags, and below are few of my findings, From all the .java files from XalanJ dev branch xalan-j_xslt3.0, that have @author tags, 1) Total number of Java files that've these tags 726 There are following two types of @author tags present, @author tags that have person's name but not email address @author tags that have person's name and email address both 2) The Java files that bear my name and email address 86 Please advise, how we should proceed given these @author tags information details, within XalanJ codebase in general. -- Regards, Mukul Gandhi --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@xalan.apache.org<mailto:dev-unsubscr...@xalan.apache.org> For additional commands, e-mail: dev-h...@xalan.apache.org<mailto:dev-h...@xalan.apache.org>
