I've changed my mind on this and now don't see a need to change current practice. Part of the original discussion was based on legal points, but was dismissed IIRC. Other apache communities have done this when they were 'broken', which I don't think commons is. So I'm against change.
Stephen ----- Original Message ----- From: "Gary Gregory" <[EMAIL PROTECTED]> > If we change the tags, [ii] seems best, since an "author" is not a project > (as in [i]). > > gg > > > -----Original Message----- > > From: John Keyes [mailto:[EMAIL PROTECTED] > > Sent: Thursday, February 19, 2004 15:37 > > To: Jakarta Commons Developers List > > Subject: [all] Author tags (again!) > > > > I've been reading the archived entries about @author javadoc tags and > > noticed that a majority (of people who posted on the topic) agree that > > the @author tags should not refer to the actual author but the > > community. > > BTW, I am not trying to start a debate on the pros and cons but I > > believe the community is the author and that is the reason for > > writing this mail. > > > > There never appeared to be a consensus on the actual format of the > > @author tag. So here are some of the possibilities: > > > > [i] @author The Apache Jakarta Commons Team > > > > [ii] @author <a > > href="http://jakarta.apache.org/commons/proj/team-list.html";> > > The Apache Jakarta Commons <proj> Team</a> > > > > [iii] @author <a href="http://jakarta.apache.org/commons/proj";> > > The Apache Jakarta Commons <proj> Team</a> > > > > I was trying to think of possible mailto: URLs but giving the user list > > address does not make sense as they need to be subscribed to > > post and the user-subscribe list does not make sense either as > > there is no instruction to the user on what to put in that mail. > > > > If anyone has any comments or suggestions I'd love to hear them. My > > preference is [ii]. > > > > -John K > > > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: [EMAIL PROTECTED] > > For additional commands, e-mail: [EMAIL PROTECTED] > --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
