You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@incubator.apache.org by Marvin Humphrey <ma...@rectangular.com> on 2016/02/01 02:30:43 UTC
Retirement guide updates
Greets,
I'm mostly done overhauling[1] the Incubator's Retirement Guide.
http://incubator.apache.org/guides/retirement
There are a couple items left.
First, is the DOAP file.
* If it is to be updated, how so? If we use
http://attic.apache.org/process.html#doap as a template, how should it be
adapted?
* When a podling retires, we zap its website and redirect to the podling
status page. If the DOAP file lived on the podling website, it's going
away, too. What do we do about that?
For volunteers who are executing the steps to retirement, figuring out what to
do about the DOAP file is a time sink. If we can't come up with concrete
steps that someone who knows nearly nothing about DOAP files can execute, I
propose to delete that task -- otherwise, it's not fair to the volunteer
handling the often-thankless work of retirement.
Second, there's a task to remove the podling mailing lists from the incubation
status page. I don't think this is important and if there are no objections,
I propose to remove that task.
Marvin Humphrey
[1] http://svn.apache.org/viewvc/incubator/public/trunk/content/guides/retirement.xml
------------------------------------------------------------------------
r1727881 | marvin | 2016-01-31 17:24:47 -0800 (Sun, 31 Jan 2016) | 2 lines
Add task to delete retiring podling dist dir.
------------------------------------------------------------------------
r1727880 | marvin | 2016-01-31 17:18:13 -0800 (Sun, 31 Jan 2016) | 5 lines
Modify conceptual explanation of retirement.
Add analogy comparing podling retirement against retiring a TLP to the
Attic, plus other wordsmithing.
------------------------------------------------------------------------
r1727875 | marvin | 2016-01-31 16:14:27 -0800 (Sun, 31 Jan 2016) | 2 lines
Add retirement step "Disable ${podling} website".
------------------------------------------------------------------------
r1727874 | marvin | 2016-01-31 16:05:55 -0800 (Sun, 31 Jan 2016) | 6 lines
Rework "steps to retirement".
Group like tasks together. Use a combination of numbered and bullet
lists, plus improve formatting in other ways. Adapt for "version
control" rather than "SVN", as well as other vocabulary changes.
------------------------------------------------------------------------
r1723936 | marvin | 2016-01-10 08:04:09 -0800 (Sun, 10 Jan 2016) | 8 lines
Streamline explanation of decision to retire.
Move the explanation of the decision to retire into its own dedicated
section. Simplify this explanation considerably.
As a side effect, the remaining text under "What is retirement" becomes
more succinct.
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Retirement guide updates
Posted by Marvin Humphrey <ma...@rectangular.com>.
On Sat, Feb 6, 2016 at 10:47 AM, Hervé BOUTEMY <he...@free.fr> wrote:
> dropping the DOAP file of a retired incubator project means removing the
> project from projects list [1]: it seems reasonable
> there is one task to do: remove the entry from projects DOAP files list [2]
Thanks, Hervé! That's nice and straightforward -- I'm confident that
anybody who can handle the rest of the retirement steps can also
handle the task of deleting a line from that file. I added a step to
the retirement guide.
Marvin Humphrey
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Retirement guide updates
Posted by Hervé BOUTEMY <he...@free.fr>.
dropping the DOAP file of a retired incubator project means removing the
project from projects list [1]: it seems reasonable
there is one task to do: remove the entry from projects DOAP files list [2]
notice that this step has to be done only when a project has previously made
the effort to create a DOAP file: incubator projects usually didn't take time to
create one (perhaps because documentation has been hard to follow until now: I
hope we'll make the process easier to understand in the future then have more
incubator DOAP files... )
Regards,
Hervé
[1] https://projects.apache.org/projects.html
[2]
http://svn.apache.org/viewvc/comdev/projects.apache.org/data/projects.xml?view=markup
Le jeudi 4 février 2016 20:51:28 Marvin Humphrey a écrit :
> On Sun, Jan 31, 2016 at 7:00 PM, John D. Ament <jo...@apache.org>
wrote:
> > I believe doap was retired in the projects-new setup.
>
> Since there have been no objections, I've made the following change:
>
> ------------------------------------------------------------------------
> r1728601 | marvin | 2016-02-04 20:45:47 -0800 (Thu, 04 Feb 2016) | 6 lines
>
> Update steps to retirement.
>
> * Remove DOAP task.
> * Remove task to delete mailing list links from status page.
> * Make website disabling self-service and clarify.
>
> At this point, the Retirement Guide should be up-to-date. A volunteer who
> is reasonably familiar with the Incubator should be able to follow the
> steps in it without too much difficulty.
>
> Marvin Humphrey
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Retirement guide updates
Posted by Marvin Humphrey <ma...@rectangular.com>.
On Sun, Jan 31, 2016 at 7:00 PM, John D. Ament <jo...@apache.org> wrote:
> I believe doap was retired in the projects-new setup.
Since there have been no objections, I've made the following change:
------------------------------------------------------------------------
r1728601 | marvin | 2016-02-04 20:45:47 -0800 (Thu, 04 Feb 2016) | 6 lines
Update steps to retirement.
* Remove DOAP task.
* Remove task to delete mailing list links from status page.
* Make website disabling self-service and clarify.
At this point, the Retirement Guide should be up-to-date. A volunteer who is
reasonably familiar with the Incubator should be able to follow the steps in
it without too much difficulty.
Marvin Humphrey
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Retirement guide updates
Posted by Hervé BOUTEMY <he...@free.fr>.
(sorry, I'm a little late in the discussion...)
no, DOAP was not retired
I tried to makes things simpler in the documentation:
https://projects.apache.org/about.html
Regards,
Hervé
Le dimanche 31 janvier 2016 22:00:18 John D. Ament a écrit :
> I believe doap was retired in the projects-new setup.
>
> On Jan 31, 2016 20:31, "Marvin Humphrey" <ma...@rectangular.com> wrote:
> > Greets,
> >
> > I'm mostly done overhauling[1] the Incubator's Retirement Guide.
> >
> > http://incubator.apache.org/guides/retirement
> >
> > There are a couple items left.
> >
> > First, is the DOAP file.
> >
> > * If it is to be updated, how so? If we use
> >
> > http://attic.apache.org/process.html#doap as a template, how should
> >
> > it be
> >
> > adapted?
> >
> > * When a podling retires, we zap its website and redirect to the podling
> >
> > status page. If the DOAP file lived on the podling website, it's
> > going
> > away, too. What do we do about that?
> >
> > For volunteers who are executing the steps to retirement, figuring out
> > what to
> > do about the DOAP file is a time sink. If we can't come up with concrete
> > steps that someone who knows nearly nothing about DOAP files can execute,
> > I
> > propose to delete that task -- otherwise, it's not fair to the volunteer
> > handling the often-thankless work of retirement.
> >
> > Second, there's a task to remove the podling mailing lists from the
> > incubation
> > status page. I don't think this is important and if there are no
> > objections,
> > I propose to remove that task.
> >
> > Marvin Humphrey
> >
> > [1]
> > http://svn.apache.org/viewvc/incubator/public/trunk/content/guides/retirem
> > ent.xml
> >
> >
> > ------------------------------------------------------------------------
> >
> > r1727881 | marvin | 2016-01-31 17:24:47 -0800 (Sun, 31 Jan 2016) | 2
> >
> > lines
> >
> > Add task to delete retiring podling dist dir.
> >
> > ------------------------------------------------------------------------
> >
> > r1727880 | marvin | 2016-01-31 17:18:13 -0800 (Sun, 31 Jan 2016) | 5
> >
> > lines
> >
> > Modify conceptual explanation of retirement.
> >
> > Add analogy comparing podling retirement against retiring a TLP to the
> > Attic, plus other wordsmithing.
> >
> > ------------------------------------------------------------------------
> >
> > r1727875 | marvin | 2016-01-31 16:14:27 -0800 (Sun, 31 Jan 2016) | 2
> >
> > lines
> >
> > Add retirement step "Disable ${podling} website".
> >
> > ------------------------------------------------------------------------
> >
> > r1727874 | marvin | 2016-01-31 16:05:55 -0800 (Sun, 31 Jan 2016) | 6
> >
> > lines
> >
> > Rework "steps to retirement".
> >
> > Group like tasks together. Use a combination of numbered and bullet
> > lists, plus improve formatting in other ways. Adapt for "version
> > control" rather than "SVN", as well as other vocabulary changes.
> >
> > ------------------------------------------------------------------------
> >
> > r1723936 | marvin | 2016-01-10 08:04:09 -0800 (Sun, 10 Jan 2016) | 8
> >
> > lines
> >
> > Streamline explanation of decision to retire.
> >
> > Move the explanation of the decision to retire into its own dedicated
> > section. Simplify this explanation considerably.
> >
> > As a side effect, the remaining text under "What is retirement"
> > becomes
> > more succinct.
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> > For additional commands, e-mail: general-help@incubator.apache.org
---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org
Re: Retirement guide updates
Posted by "John D. Ament" <jo...@apache.org>.
I believe doap was retired in the projects-new setup.
On Jan 31, 2016 20:31, "Marvin Humphrey" <ma...@rectangular.com> wrote:
> Greets,
>
> I'm mostly done overhauling[1] the Incubator's Retirement Guide.
>
> http://incubator.apache.org/guides/retirement
>
> There are a couple items left.
>
> First, is the DOAP file.
>
> * If it is to be updated, how so? If we use
> http://attic.apache.org/process.html#doap as a template, how should
> it be
> adapted?
> * When a podling retires, we zap its website and redirect to the podling
> status page. If the DOAP file lived on the podling website, it's going
> away, too. What do we do about that?
>
> For volunteers who are executing the steps to retirement, figuring out
> what to
> do about the DOAP file is a time sink. If we can't come up with concrete
> steps that someone who knows nearly nothing about DOAP files can execute, I
> propose to delete that task -- otherwise, it's not fair to the volunteer
> handling the often-thankless work of retirement.
>
> Second, there's a task to remove the podling mailing lists from the
> incubation
> status page. I don't think this is important and if there are no
> objections,
> I propose to remove that task.
>
> Marvin Humphrey
>
> [1]
> http://svn.apache.org/viewvc/incubator/public/trunk/content/guides/retirement.xml
>
>
> ------------------------------------------------------------------------
> r1727881 | marvin | 2016-01-31 17:24:47 -0800 (Sun, 31 Jan 2016) | 2
> lines
>
> Add task to delete retiring podling dist dir.
>
>
> ------------------------------------------------------------------------
> r1727880 | marvin | 2016-01-31 17:18:13 -0800 (Sun, 31 Jan 2016) | 5
> lines
>
> Modify conceptual explanation of retirement.
>
> Add analogy comparing podling retirement against retiring a TLP to the
> Attic, plus other wordsmithing.
>
>
> ------------------------------------------------------------------------
> r1727875 | marvin | 2016-01-31 16:14:27 -0800 (Sun, 31 Jan 2016) | 2
> lines
>
> Add retirement step "Disable ${podling} website".
>
>
> ------------------------------------------------------------------------
> r1727874 | marvin | 2016-01-31 16:05:55 -0800 (Sun, 31 Jan 2016) | 6
> lines
>
> Rework "steps to retirement".
>
> Group like tasks together. Use a combination of numbered and bullet
> lists, plus improve formatting in other ways. Adapt for "version
> control" rather than "SVN", as well as other vocabulary changes.
>
>
> ------------------------------------------------------------------------
> r1723936 | marvin | 2016-01-10 08:04:09 -0800 (Sun, 10 Jan 2016) | 8
> lines
>
> Streamline explanation of decision to retire.
>
> Move the explanation of the decision to retire into its own dedicated
> section. Simplify this explanation considerably.
>
> As a side effect, the remaining text under "What is retirement" becomes
> more succinct.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
> For additional commands, e-mail: general-help@incubator.apache.org
>
>