Apache Commons logo

Introduction

Proper components may be moved to dormant for a number of reasons including:

  • No development activity for a long while
  • Better alternatives are available either as open source libraries or in newer releases of the JDK
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.

Preparation

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 svnsearch. If there are no objecttions against moving the component for formal vote should be called:

      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>
    

Moving the component

If the vote for moving the component to dormant was successful you can start with the actual work.

Ask Infra to deactivate the git mirror. You can use INFRA-7454 as a template.

After the synchronization has been deactivated, move the code base in SVN:

      svn mv -m "Move commons foo to dormant" 
      https://svn.apache.org/repos/commons/proper/foo 
      https://svn.apache.org/repos/commons/dormant/
      

Move the website:

      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/
      

Update references on the main website. The following pages have to be modified (relative to this document):

  • components.xml
  • dormant.xml
  • index.xml.vm
  • downloads/index.xml

Announcement

After the component has been moved, an announcement should be send to dev@ and users@

      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