You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@struts.apache.org by "Pilgrim, Peter" <pe...@csfb.com> on 2005/01/27 10:59:55 UTC
Removal of Author Tags [was RE: Documentation updates part 2]
> -----Original Message-----
> From: Paul Sundling [mailto:tkz@tkz.net]
==////==
>
> First off, I see that the documentation equivalent of author tags are
> still being used. I remember there was the big thing about
> removing the
> author tags from all java code. There was even an article on the
> theinquirer.net about it: http://www.theinquirer.net/?article=14917
> Anyway, let me know if those doc authors should be removed and I'll
> submit a patch.
>
> Incidentally, when I submitted a patch to the maven hosted changelog
> plugin last week, I noticed author tags. I also see author
> tags in this
> project again. Is it backsliding, or did the policy change? I could
> also do a patch removing author tags as well.
>
> Removing all of these would seem consistent with removing the previous
> contributors page.
>
Why do you want to remove author tags from the source code base?
Have you totally absolved yourselves from developer attributions?
==////==
--
Peter Pilgrim
Operations/IT - Credit Suisse First Boston,
10 South Colonnade, London E14 4QJ, United Kingdom
Tel: +44-(0)207-883-4497
==============================================================================
This message is for the sole use of the intended recipient. If you received
this message in error please delete it and notify us. If this message was
misdirected, CSFB does not waive any confidentiality or privilege. CSFB
retains and monitors electronic communications sent through its network.
Instructions transmitted over this system are not binding on CSFB until they
are confirmed by us. Message transmission is not guaranteed to be secure.
==============================================================================
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org
Re: Removal of Author Tags [was RE: Documentation updates part 2]
Posted by James Mitchell <jm...@apache.org>.
Hi Paul
I was already working on this when Ted mentioned to me that you were doing
it. After reading this, I will let you handle it. I really appreciate your
help. It's volunteering like this that gets people nominated ;)
Is there a bugzilla ticket opened for this yet? If so, I will attach a
patch for what I've done. If you have time, you can take a look at it and
let me know if this helps, or is a starting point. I'm sure I've missed
something.
--
James Mitchell
Software Engineer / Open Source Evangelist
EdgeTech, Inc.
678.910.8017
AIM: jmitchtx
----- Original Message -----
From: "Paul Sundling" <tk...@tkz.net>
To: "Struts Developers List" <de...@struts.apache.org>
Sent: Thursday, January 27, 2005 7:52 AM
Subject: Re: Removal of Author Tags [was RE: Documentation updates part 2]
> When the ASF directive came down to remove all java author tags I
> actually did the patch that took care of it, including my own author
> tag. :)
>
> At that time I actually collected all the names and added them to the
> volunteers page. At the time, it had all the contributers, big and
> small. Later that was also removed and now only a page listing the
> committers and PMC members remains.
>
> Anyway that's why I remember that author tags were supposed to be
> removed. It does say we don't use author tags even in the how to help
> FAQ and says if a patch is submitted with author tags, the submitter may
> be asked to remove them. (!) So as Ted Husted points out, this has been
> policy for a while.
>
> I'll submit a seperate bug report and patch to remove all author tags,
> including docs tonight. Since it affects lots of files, I hope the
> committers will act quickly or not at all.
>
> After the smoke clears on this and the other patch I already submitted
> to fix docs and mention using current, I'll follow up on the remaining
> issues I noted.
>
> Paul Sundling
>
>
> On Thu, 2005-01-27 at 09:59 +0000, Pilgrim, Peter wrote:
>> > -----Original Message-----
>> > From: Paul Sundling [mailto:tkz@tkz.net]
>>
>> ==////==
>>
>> >
>> > First off, I see that the documentation equivalent of author tags are
>> > still being used. I remember there was the big thing about
>> > removing the
>> > author tags from all java code. There was even an article on the
>> > theinquirer.net about it: http://www.theinquirer.net/?article=14917
>> > Anyway, let me know if those doc authors should be removed and I'll
>> > submit a patch.
>> >
>> > Incidentally, when I submitted a patch to the maven hosted changelog
>> > plugin last week, I noticed author tags. I also see author
>> > tags in this
>> > project again. Is it backsliding, or did the policy change? I could
>> > also do a patch removing author tags as well.
>> >
>> > Removing all of these would seem consistent with removing the previous
>> > contributors page.
>> >
>>
>> Why do you want to remove author tags from the source code base?
>> Have you totally absolved yourselves from developer attributions?
>>
>> ==////==
>>
>> --
>> Peter Pilgrim
>> Operations/IT - Credit Suisse First Boston,
>> 10 South Colonnade, London E14 4QJ, United Kingdom
>> Tel: +44-(0)207-883-4497
>>
>>
>> ==============================================================================
>> This message is for the sole use of the intended recipient. If you
>> received
>> this message in error please delete it and notify us. If this message was
>> misdirected, CSFB does not waive any confidentiality or privilege. CSFB
>> retains and monitors electronic communications sent through its network.
>> Instructions transmitted over this system are not binding on CSFB until
>> they
>> are confirmed by us. Message transmission is not guaranteed to be secure.
>> ==============================================================================
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
>> For additional commands, e-mail: dev-help@struts.apache.org
>>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
> For additional commands, e-mail: dev-help@struts.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org
Re: Removal of Author Tags [was RE: Documentation updates part 2]
Posted by Paul Sundling <tk...@tkz.net>.
When the ASF directive came down to remove all java author tags I
actually did the patch that took care of it, including my own author
tag. :)
At that time I actually collected all the names and added them to the
volunteers page. At the time, it had all the contributers, big and
small. Later that was also removed and now only a page listing the
committers and PMC members remains.
Anyway that's why I remember that author tags were supposed to be
removed. It does say we don't use author tags even in the how to help
FAQ and says if a patch is submitted with author tags, the submitter may
be asked to remove them. (!) So as Ted Husted points out, this has been
policy for a while.
I'll submit a seperate bug report and patch to remove all author tags,
including docs tonight. Since it affects lots of files, I hope the
committers will act quickly or not at all.
After the smoke clears on this and the other patch I already submitted
to fix docs and mention using current, I'll follow up on the remaining
issues I noted.
Paul Sundling
On Thu, 2005-01-27 at 09:59 +0000, Pilgrim, Peter wrote:
> > -----Original Message-----
> > From: Paul Sundling [mailto:tkz@tkz.net]
>
> ==////==
>
> >
> > First off, I see that the documentation equivalent of author tags are
> > still being used. I remember there was the big thing about
> > removing the
> > author tags from all java code. There was even an article on the
> > theinquirer.net about it: http://www.theinquirer.net/?article=14917
> > Anyway, let me know if those doc authors should be removed and I'll
> > submit a patch.
> >
> > Incidentally, when I submitted a patch to the maven hosted changelog
> > plugin last week, I noticed author tags. I also see author
> > tags in this
> > project again. Is it backsliding, or did the policy change? I could
> > also do a patch removing author tags as well.
> >
> > Removing all of these would seem consistent with removing the previous
> > contributors page.
> >
>
> Why do you want to remove author tags from the source code base?
> Have you totally absolved yourselves from developer attributions?
>
> ==////==
>
> --
> Peter Pilgrim
> Operations/IT - Credit Suisse First Boston,
> 10 South Colonnade, London E14 4QJ, United Kingdom
> Tel: +44-(0)207-883-4497
>
>
> ==============================================================================
> This message is for the sole use of the intended recipient. If you received
> this message in error please delete it and notify us. If this message was
> misdirected, CSFB does not waive any confidentiality or privilege. CSFB
> retains and monitors electronic communications sent through its network.
> Instructions transmitted over this system are not binding on CSFB until they
> are confirmed by us. Message transmission is not guaranteed to be secure.
> ==============================================================================
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
> For additional commands, e-mail: dev-help@struts.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org
Re: Removal of Author Tags [was RE: Documentation updates part 2]
Posted by Ted Husted <hu...@apache.org>.
On Thu, 27 Jan 2005 06:32:36 -0500, Ted Husted wrote:
> I'll look around for a summary or post one myself.
Here's a post of mine from last March.
--- Original Message ---
From: "Ted Husted" <hu...@apache.org>
To: <me...@apache.org>
Cc:
Sent: Wed, 24 Mar 2004 09:24:19 -0500
Subject: Re: Apache enforces the removal of author tags
> IMHO, at some point, issues like this come down to trusting the
> judgment of those which have gone before us. The consensus among
> Apaches who have been doing this for a long time now is that author
> tags create more problems than they solve. Even in the brief four
> years that we have been working on Struts, we came to the same
> conclusion. We removed the author tags, and everyone is fine with
> it.
>
> The board has simply *recommended* that communities do without
> author tags. So call it an ASF "best practice" if you will. If a
> community is happier keeping the tags, no one is telling a
> community they have to remove them. It's up to each community to
> decide for themselves. Ant, Struts, et al, removed them. Others are
> keeping them.
>
> This has gone 'round and 'round the mulberry bush on the Jakarta
> PMC list, and, despite the investment in bandwidth, I don't thing
> anyone's mind was changed in the end. Either you don't agree with
> the points made by Greg Stein's post to the community list:
>
> <http://tinyurl.com/yrlhu>
>
> or you don't.
>
> On some points, we have to agree to disagree and move on.
If Greg's post isn't enough, here are some other links:
* http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=107788069123268&w=2
* http://www.anyware-tech.com/blogs/sylvain/archives/000109.html
-Ted.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org
Re: Removal of Author Tags [was RE: Documentation updates part 2]
Posted by Ted Husted <hu...@apache.org>.
On Thu, 27 Jan 2005 09:59:55 +0000, Pilgrim, Peter wrote:
> Why do you want to remove author tags from the source code base?
> Have you totally absolved yourselves from developer attributions?
We removed the author tags from the source code base a little over a year ago. We just never bothered to do the same with the documentation. As a top-level project, Apache Struts has never used author tags in the source code.
There are several legal and social reasons why author tags should not be used. The pros and cons have been discussed at length within the Foundation. I'll look around for a summary or post one myself. The board discourages (but does not prohibit) author tags. Some projects still use them, but most ASF projects either never used author tags or have now removed them. Documentation should not be treated differently than code.
-Ted.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@struts.apache.org
For additional commands, e-mail: dev-help@struts.apache.org