Author: britter
Date: Sun Mar 16 15:40:06 2014
New Revision: 1578108
URL: http://svn.apache.org/r1578108
Log:
Add documentation on how to move components to dormant
Added:
commons/cms-site/trunk/content/xdoc/releases/moving-to-dormant.xml (with
props)
Modified:
commons/cms-site/trunk/content/xdoc/releases/index.xml
Modified: commons/cms-site/trunk/content/xdoc/releases/index.xml
URL:
http://svn.apache.org/viewvc/commons/cms-site/trunk/content/xdoc/releases/index.xml?rev=1578108&r1=1578107&r2=1578108&view=diff
==============================================================================
--- commons/cms-site/trunk/content/xdoc/releases/index.xml (original)
+++ commons/cms-site/trunk/content/xdoc/releases/index.xml Sun Mar 16 15:40:06
2014
@@ -44,6 +44,7 @@
<li><a href='release.html'>Publishing The Release - Step By
Step</a></li>
<li><a href='versioning.html'>Versioning Guidelines</a></li>
<li><a href='publish-site.html'>Publishing the Website</a></li>
+ <li><a href='moving-to-dormant.html'>Moving proper components to
dormant</a></li>
<!-- <li><a
href="http://wiki.apache.org/commons/MovingFromSandboxToProper";>Sandbox
Promotion</a></li> -->
</ul>
</p>
Added: commons/cms-site/trunk/content/xdoc/releases/moving-to-dormant.xml
URL:
http://svn.apache.org/viewvc/commons/cms-site/trunk/content/xdoc/releases/moving-to-dormant.xml?rev=1578108&view=auto
==============================================================================
--- commons/cms-site/trunk/content/xdoc/releases/moving-to-dormant.xml (added)
+++ commons/cms-site/trunk/content/xdoc/releases/moving-to-dormant.xml Sun Mar
16 15:40:06 2014
@@ -0,0 +1,126 @@
+<?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>
+ <title>Moving components to dormant</title>
+ <author email="[email protected]">Commons Documentation Team</author>
+ </properties>
+
+ <body>
+ <section name='Introduction'>
+ <p>
+ Proper components may be moved to dormant for a number of reasons
including:
+ <ul>
+ <li>No development activity for a long while</li>
+ <li>Better alternatives are available either as open source libraries or
in newer releases of the JDK</li>
+ </ul>
+ To move a component to dormangt a number of thinks have to be taken care
of.
+ This page explains what is necessary to move a proper component to dormant.
+ </p>
+
+ </section>
+ <section name="Preparation">
+ <p>
+ If you feel that one of the proper components could be moved to dormant
you should first ask the dev ML.
+ Start a [DISCUSS] explaining the rational for moving the component to
dormant.
+ A good indicator for lacking development activity may be <a
href="http://svnsearch.org";>svnsearch</a>.
+ If there are no objecttions against moving the component for formal vote
should be called:
+ </p>
+ <pre>
+ Hi all,
+
+ as discussed, I'd like to propose to move Apache Commons Foo to dormant.
+
+ Reasons:
+ - some reasons
+ - ...
+
+ So please cast your votes:
+ This vote will close no sooner that 72 hours from now,
+ i.e. after 21:30CET 14 March 2014
+
+ [ ] +1 Move Commons Foo to dormant
+ [ ] +/-0 I'm undecided on this concern
+ [ ] -1 No, do NOT move Commons Foo to dormant (because....)
+
+ Thanks!
+ <your name>
+ </pre>
+ </section>
+ <section name="Moving the component">
+ <p>
+ If the vote for moving the component to dormant was successful you can
start with the actual work.
+ </p>
+
+ <p>Ask Infra to deactivate the <a href="http://git.apache.org";>git
mirror</a>. You can use <a
href="https://issues.apache.org/jira/browse/INFRA-7454";>INFRA-7454</a> as a
template.</p>
+
+ <p>After the synchronization has been deactivated, move the code base in
SVN:
+ <pre>
+ svn mv -m "Move commons foo to dormant"
+ https://svn.apache.org/repos/commons/proper/foo
+ https://svn.apache.org/repos/commons/dormant/
+ </pre>
+ </p>
+ <p>Move the website:
+ <pre>
+ svn mv -m "Move commons foo website to dormant"
+
https://svn.apache.org/repos/infra/websites/production/commons/content/proper/commons-foo
+
https://svn.apache.org/repos/infra/websites/production/commons/content/dormant/
+ </pre>
+ </p>
+ <p>Update references on the main website. The following pages have to be
modified (relative to this document):
+ <ul>
+ <li>components.xml</li>
+ <li>dormant.xml</li>
+ <li>index.xml.vm</li>
+ <li>downloads/index.xml</li>
+ </ul>
+ </p>
+ </section>
+ <section name="Announcement">
+ <p>
+ After the component has been moved, an announcement should be send to
dev@ and users@
+ </p>
+ <pre>
+ Hi,
+
+ since no development has happened for a long while, the Apache Commons
Foo component
+ has been moved to dormant. No further development is expected.
+
+ The SVN location has changed from:
+ https://svn.apache.org/repos/asf/commons/proper/foo
+ to:
+ https://svn.apache.org/repos/asf/commons/dormant/foor
+
+ Synchronization of the git mirror (git://git.apache.org/commons-foo.git)
has been deactivated.
+
+ The website has moved from:
+ http://commons.apache.org/proper/commons-foo/
+ to:
+ http://commons.apache.org/dormant/commons-foo/
+
+ Regards,
+ <your name>, on behalf of the Apache Commons community
+ </pre>
+ </section>
+
+
+ </body>
+</document>
Propchange: commons/cms-site/trunk/content/xdoc/releases/moving-to-dormant.xml
------------------------------------------------------------------------------
svn:eol-style = native
