Hi Gary & all,

On Sat, Jul 1, 2023 at 5:10 PM Gary Gregory <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
For additional commands, e-mail: dev-h...@xalan.apache.org

Reply via email to