You are viewing a plain text version of this content. The canonical link for it is here.
Posted to general@attic.apache.org by ba...@apache.org on 2009/05/23 09:36:21 UTC
svn commit: r777818 - in /attic/site: docs/index.html docs/process.html
docs/projects/hivemind.html docs/resolution.html xdocs/process.xml
xdocs/stylesheets/project.xml
Author: bayard
Date: Sat May 23 07:36:20 2009
New Revision: 777818
URL: http://svn.apache.org/viewvc?rev=777818&view=rev
Log:
Adding process page
Added:
attic/site/docs/process.html (with props)
attic/site/xdocs/process.xml (with props)
Modified:
attic/site/docs/index.html
attic/site/docs/projects/hivemind.html
attic/site/docs/resolution.html
attic/site/xdocs/stylesheets/project.xml
Modified: attic/site/docs/index.html
URL: http://svn.apache.org/viewvc/attic/site/docs/index.html?rev=777818&r1=777817&r2=777818&view=diff
==============================================================================
--- attic/site/docs/index.html (original)
+++ attic/site/docs/index.html Sat May 23 07:36:20 2009
@@ -155,6 +155,7 @@
<div class="menuheader">The Apache Attic</div>
<ul>
<li><a href="http://attic.apache.org/">Home</a></li>
+ <li><a href="http://attic.apache.org/process.html">Process</a></li>
</ul>
<div class="menuheader">Related Links</div>
<ul>
Added: attic/site/docs/process.html
URL: http://svn.apache.org/viewvc/attic/site/docs/process.html?rev=777818&view=auto
==============================================================================
--- attic/site/docs/process.html (added)
+++ attic/site/docs/process.html Sat May 23 07:36:20 2009
@@ -0,0 +1,251 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+ "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<html xmlns="http://www.w3.org/1999/xhtml">
+ <head>
+ <!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from XML source: DO NOT EDIT!
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
+ <link rel="stylesheet" href="http://www.apache.org/style/compressed.css" type="text/css" media="screen, projection"/>
+ <link rel="stylesheet" href="http://www.apache.org/style/style.css" type="text/css" media="screen, projection"/>
+ <!--[if IE]><link rel="stylesheet" href="http://www.apache.org/style/ie.css" type="text/css" media="screen, projection"/><![endif]-->
+ <meta name="author" content="The Apache Software Foundation" /><meta name="email" content="general.AT.attic.apache.DOT.org" />
+ <title>Moving a project to the Attic - Apache Attic</title>
+
+ </head>
+ <body id="sub">
+ <div class="container">
+ <hr class="space col"/>
+ <div class="block">
+ <div class="column span-24">
+ <div id="header">
+ <!-- Add 'default' header section here. -->
+ <h1>Moving a project to the Attic</h1>
+ </div>
+ </div>
+ </div>
+ <hr/>
+ <div class="block">
+ <div class="column span-8 prepend-16 search searchsub">
+ <form action="http://www.google.com/search" method="get">
+ <input value="attic.apache.org" name="sitesearch" type="hidden"/>
+ <input size="10" name="q" id="query" type="text"/>
+ <input name="Search" value="Go" type="submit"/>
+ </form>
+ </div>
+ </div>
+ <div class="block content">
+ <div class="column span-15 colborder">
+
+<div class="section-content">
+<p>At some point a project will vote to join the Attic. The following defines a process
+ to move that project into the Attic and gently close it down. </p>
+<ol>
+ <li>Open a JIRA item - 'Move ${project} to the Attic'. </li>
+ <li>Open a subtask: Board resolution successful. </li>
+ <li>Ensure a Board resolution is on the next Board agenda. Once this is successful, continue. </li>
+ <li>Open the following subtasks (see below for more information):
+ <ul>
+ <li>Inform users</li>
+ <li>Update website with Attic notice</li>
+ <li>Update README in downloads</li>
+ <li>Make SVN + JIRA/Bugzilla read-only</li>
+ <li>Create page on Attic site</li>
+ <li>Turn off automated builds</li>
+ <li>Remove from www.apache.org navigation</li>
+ <li>Close down infrastructure resources</li>
+ <li>Announce on announce at apache.org</li>
+ </ul>
+ </li>
+ <li>Open a new ticket to consider deleting the user list with a due date 6 months in the future</li>
+ </ol>
+</div>
+
+<h4 id="informing">
+ Informing users of the vote
+</h4>
+<div class="section-content">
+<p>Your first task is to let the users know that the project is moving into the Attic. Consider the following template: </p>
+<pre>
+A heads up for the ${project} user community that the ${project} project has
+been 'moved to the Attic'. This means that the ${project} developers (more
+formally its Project Management Committee) have voted to retire ${project}
+and move the responsibility for its oversight over to the Attic project.
+
+Loosely speaking this means that the projects resources will be moved to a
+read-only state.
+
+You can read more about the Apache Attic and the process of moving to the
+Attic at http://attic.apache.org.
+
+You can follow this process in JIRA:
+
+ https://issues.apache.org/jira/browse/ATTIC-${#}
+
+Thanks,
+
+${Name} on behalf of ${project} + the Attic.
+ </pre>
+</div>
+
+<h4 id="website">
+ Adding an Attic notice to the website
+</h4>
+<div class="section-content">
+<p>A banner needs to be added to the website indicating that it is now in the Attic. This needs to be done in a lightweight way
+ without having to learn how the project manage their site. The simplest way is to (carefully!) search and replace for a common
+ tag such as the body tag. </p>
+</div>
+
+<h4 id="downloads">
+ Update README in downloads
+</h4>
+<div class="section-content">
+<p>Another area to take note of the move to the Attic is the download section. Add or update a README.html file that says something like: </p>
+<pre>
+YYYY/MM/DD - Apache ${project} has been retired.
+
+For more information, please explore the Attic at http://attic.apache.org
+ </pre>
+</div>
+
+<h4 id="readonly">
+ Make SVN + JIRA/Bugzilla read-only
+</h4>
+<div class="section-content">
+<p>Someone with SVN karma karma should edit the asf-authorization file. The project's karma should be moved to read-only and the commit
+ notification should be pointed to general@attic.apache.org. </p>
+<p>Someone with JIRA or Bugzilla administrative rights should modify the project to be read-only. In JIRA this means moving it to the Retired
+ category and applying the Read-Only Permissions. </p>
+</div>
+
+<h4 id="atticsite">
+ Create page on Attic site
+</h4>
+<div class="section-content">
+<p>A simple page should be created on the Attic site. Use existing pages as templates. While you are here, add the user mailing list to the list
+ of sites under the Attic's oversight. </p>
+</div>
+
+<h4 id="builds">
+ Turn off automated builds
+</h4>
+<div class="section-content">
+<p>Research to find out if an automated build exists and get it turned off. </p>
+</div>
+
+<h4 id="www.apache">
+ Remove from www.apache.org navigation
+</h4>
+<div class="section-content">
+<p>As a retired project, a link on the front page of Apache is no longer necessary. Remove the link and regenerate the main Apache site. </p>
+</div>
+
+<h4 id="infra">
+ Close down infrastructure resources
+</h4>
+<div class="section-content">
+<p>Open a ticket with Infrastructure asking for resources to be closed down. This includes: </p>
+<ul>
+ <li>JIRA, Bugzilla + SVN if no one has karma</li>
+ <li>Closing down of dev@, commits@ and private@ mailing lists</li>
+ <li>Read-only in wiki (be it Confluence or Moinmoin)</li>
+ <li>Delete unix group</li>
+ <li>New moderator for user@ list</li>
+ </ul>
+<p>Bear in mind you will need to identify who is volunteering as the new moderator for the user@ list will be. </p>
+</div>
+
+<h4 id="announce">
+ Announce on announce@apache.org
+</h4>
+<div class="section-content">
+<p>Announce that the project is now retired. Consider the following template. </p>
+<pre>
+Announcing that the Apache ${project} committers have voted to retire
+the project due to inactivity. ${project} was {boilerplate}.
+
+Retiring a project is not as simple as turning everything off, as
+existing users need to both know that the project is retiring and
+retain access to the necessary information for their own development
+efforts.
+
+You can read more about ${project}'s retirement at:
+
+ http://attic.apache.org/projects/${project}.html
+
+The user mailing list remains open, while the rest of the project's
+resources will continue to be available in a read-only state -
+website, wikis, svn, downloads and bug tracker with no change in url.
+
+Providing process and solutions to make it clear when an Apache
+project has reached its end of life is the role of the Apache Attic,
+and you can read more about that at:
+
+ http://attic.apache.org/
+
+Thanks,
+
+${NAME}
+on behalf of the Apache Attic and the now retired Apache ${project} project
+ </pre>
+<p>It's important to include the boilerplate from the project's site so people
+ know what we're talking about. </p>
+</div>
+ </div>
+ <div class="column span-8 last">
+ <div class="block">
+ <div class="nav column span-11">
+ <div>
+ <div class="menuheader">The Apache Attic</div>
+ <ul>
+ <li><a href="http://attic.apache.org/">Home</a></li>
+ <li><a href="http://attic.apache.org/process.html">Process</a></li>
+ </ul>
+ <div class="menuheader">Related Links</div>
+ <ul>
+ <li><a href="http://incubator.apache.org/">Apache Incubator</a></li>
+ </ul>
+ </div>
+ </div>
+ <div class="nav column prepend-1 span-12 last">
+ <h6>Projects in the Attic</h6>
+ <ul>
+ <li><a href="projects/hivemind.html">HiveMind</a></li>
+ </ul>
+ <h6>Mailling lists in the Attic</h6>
+ <ul>
+ <li>hivemind-user</li>
+ </ul>
+ </div>
+ </div>
+ </div>
+ <div class="column span-24 footer">
+ <hr/>
+ <p>Copyright © 2009 The Apache Software Foundation, Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+ </div>
+ </div>
+ </div>
+</body>
+</html>
+
Propchange: attic/site/docs/process.html
------------------------------------------------------------------------------
svn:eol-style = native
Modified: attic/site/docs/projects/hivemind.html
URL: http://svn.apache.org/viewvc/attic/site/docs/projects/hivemind.html?rev=777818&r1=777817&r2=777818&view=diff
==============================================================================
--- attic/site/docs/projects/hivemind.html (original)
+++ attic/site/docs/projects/hivemind.html Sat May 23 07:36:20 2009
@@ -77,6 +77,7 @@
<div class="menuheader">The Apache Attic</div>
<ul>
<li><a href="http://attic.apache.org/">Home</a></li>
+ <li><a href="http://attic.apache.org/process.html">Process</a></li>
</ul>
<div class="menuheader">Related Links</div>
<ul>
Modified: attic/site/docs/resolution.html
URL: http://svn.apache.org/viewvc/attic/site/docs/resolution.html?rev=777818&r1=777817&r2=777818&view=diff
==============================================================================
--- attic/site/docs/resolution.html (original)
+++ attic/site/docs/resolution.html Sat May 23 07:36:20 2009
@@ -88,6 +88,7 @@
<div class="menuheader">The Apache Attic</div>
<ul>
<li><a href="http://attic.apache.org/">Home</a></li>
+ <li><a href="http://attic.apache.org/process.html">Process</a></li>
</ul>
<div class="menuheader">Related Links</div>
<ul>
Added: attic/site/xdocs/process.xml
URL: http://svn.apache.org/viewvc/attic/site/xdocs/process.xml?rev=777818&view=auto
==============================================================================
--- attic/site/xdocs/process.xml (added)
+++ attic/site/xdocs/process.xml Sat May 23 07:36:20 2009
@@ -0,0 +1,186 @@
+<?xml version="1.0"?>
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one
+ or more contributor license agreements. See the NOTICE file
+ distributed with this work for additional information
+ regarding copyright ownership. The ASF licenses this file
+ to you under the Apache License, Version 2.0 (the
+ "License"); you may not use this file except in compliance
+ with the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing,
+ software distributed under the License is distributed on an
+ "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ KIND, either express or implied. See the License for the
+ specific language governing permissions and limitations
+ under the License.
+-->
+<document>
+ <properties>
+ <author email="general.AT.attic.apache.DOT.org">The Apache Software Foundation</author>
+ <title>Moving a project to the Attic</title>
+ </properties>
+<body>
+
+<section id="moving">
+ <title>Moving a project to the Attic</title>
+
+ <p>At some point a project will vote to join the Attic. The following defines a process
+ to move that project into the Attic and gently close it down. </p>
+
+ <ol>
+ <li>Open a JIRA item - 'Move ${project} to the Attic'. </li>
+ <li>Open a subtask: Board resolution successful. </li>
+ <li>Ensure a Board resolution is on the next Board agenda. Once this is successful, continue. </li>
+ <li>Open the following subtasks (see below for more information):
+ <ul>
+ <li>Inform users</li>
+ <li>Update website with Attic notice</li>
+ <li>Update README in downloads</li>
+ <li>Make SVN + JIRA/Bugzilla read-only</li>
+ <li>Create page on Attic site</li>
+ <li>Turn off automated builds</li>
+ <li>Remove from www.apache.org navigation</li>
+ <li>Close down infrastructure resources</li>
+ <li>Announce on announce at apache.org</li>
+ </ul>
+ </li>
+ <li>Open a new ticket to consider deleting the user list with a due date 6 months in the future</li>
+ </ol>
+
+</section>
+
+<section id="informing">
+ <title>Informing users of the vote</title>
+
+ <p>Your first task is to let the users know that the project is moving into the Attic. Consider the following template: </p>
+
+ <pre>
+A heads up for the ${project} user community that the ${project} project has
+been 'moved to the Attic'. This means that the ${project} developers (more
+formally its Project Management Committee) have voted to retire ${project}
+and move the responsibility for its oversight over to the Attic project.
+
+Loosely speaking this means that the projects resources will be moved to a
+read-only state.
+
+You can read more about the Apache Attic and the process of moving to the
+Attic at http://attic.apache.org.
+
+You can follow this process in JIRA:
+
+ https://issues.apache.org/jira/browse/ATTIC-${#}
+
+Thanks,
+
+${Name} on behalf of ${project} + the Attic.
+ </pre>
+</section>
+
+<section id="website">
+ <title>Adding an Attic notice to the website</title>
+
+ <p>A banner needs to be added to the website indicating that it is now in the Attic. This needs to be done in a lightweight way
+ without having to learn how the project manage their site. The simplest way is to (carefully!) search and replace for a common
+ tag such as the body tag. </p>
+</section>
+
+<section id="downloads">
+ <title>Update README in downloads</title>
+
+ <p>Another area to take note of the move to the Attic is the download section. Add or update a README.html file that says something like: </p>
+
+ <pre>
+YYYY/MM/DD - Apache ${project} has been retired.
+
+For more information, please explore the Attic at http://attic.apache.org
+ </pre>
+</section>
+
+<section id="readonly">
+ <title>Make SVN + JIRA/Bugzilla read-only</title>
+
+ <p>Someone with SVN karma karma should edit the asf-authorization file. The project's karma should be moved to read-only and the commit
+ notification should be pointed to general@attic.apache.org. </p>
+
+ <p>Someone with JIRA or Bugzilla administrative rights should modify the project to be read-only. In JIRA this means moving it to the Retired
+ category and applying the Read-Only Permissions. </p>
+</section>
+
+<section id="atticsite">
+ <title>Create page on Attic site</title>
+
+ <p>A simple page should be created on the Attic site. Use existing pages as templates. While you are here, add the user mailing list to the list
+ of sites under the Attic's oversight. </p>
+</section>
+
+<section id="builds">
+ <title>Turn off automated builds</title>
+
+ <p>Research to find out if an automated build exists and get it turned off. </p>
+</section>
+
+<section id="www.apache">
+ <title>Remove from www.apache.org navigation</title>
+
+ <p>As a retired project, a link on the front page of Apache is no longer necessary. Remove the link and regenerate the main Apache site. </p>
+</section>
+
+<section id="infra">
+ <title>Close down infrastructure resources</title>
+
+ <p>Open a ticket with Infrastructure asking for resources to be closed down. This includes: </p>
+
+ <ul>
+ <li>JIRA, Bugzilla + SVN if no one has karma</li>
+ <li>Closing down of dev@, commits@ and private@ mailing lists</li>
+ <li>Read-only in wiki (be it Confluence or Moinmoin)</li>
+ <li>Delete unix group</li>
+ <li>New moderator for user@ list</li>
+ </ul>
+
+ <p>Bear in mind you will need to identify who is volunteering as the new moderator for the user@ list will be. </p>
+</section>
+
+<section id="announce">
+ <title>Announce on announce@apache.org</title>
+
+ <p>Announce that the project is now retired. Consider the following template. </p>
+
+ <pre>
+Announcing that the Apache ${project} committers have voted to retire
+the project due to inactivity. ${project} was {boilerplate}.
+
+Retiring a project is not as simple as turning everything off, as
+existing users need to both know that the project is retiring and
+retain access to the necessary information for their own development
+efforts.
+
+You can read more about ${project}'s retirement at:
+
+ http://attic.apache.org/projects/${project}.html
+
+The user mailing list remains open, while the rest of the project's
+resources will continue to be available in a read-only state -
+website, wikis, svn, downloads and bug tracker with no change in url.
+
+Providing process and solutions to make it clear when an Apache
+project has reached its end of life is the role of the Apache Attic,
+and you can read more about that at:
+
+ http://attic.apache.org/
+
+Thanks,
+
+${NAME}
+on behalf of the Apache Attic and the now retired Apache ${project} project
+ </pre>
+
+ <p>It's important to include the boilerplate from the project's site so people
+ know what we're talking about. </p>
+</section>
+
+</body>
+</document>
Propchange: attic/site/xdocs/process.xml
------------------------------------------------------------------------------
svn:eol-style = native
Modified: attic/site/xdocs/stylesheets/project.xml
URL: http://svn.apache.org/viewvc/attic/site/xdocs/stylesheets/project.xml?rev=777818&r1=777817&r2=777818&view=diff
==============================================================================
--- attic/site/xdocs/stylesheets/project.xml (original)
+++ attic/site/xdocs/stylesheets/project.xml Sat May 23 07:36:20 2009
@@ -23,6 +23,7 @@
<projects><title>The Apache Attic</title>
<li><a href="http://attic.apache.org/">Home</a></li>
+ <li><a href="http://attic.apache.org/process.html">Process</a></li>
</projects>
<projects><title>Related Links</title>