======================
 Components TODO List
======================

 - Installation:
    - Ensure that PEAR gets all required dependencies installed (probably a package.xml v1 problem).
    - Ensure Horde_Role gets installed.

 - Allow updating Jonah during the release.

 - Add a horde-web update task during release.

 - Allow to configure the mail transport for sending announcements.

 - commit 698b6e94db5dd8d8d6b49578f75 (system() vs exec())

 - Bootstrapping script
   - must be able to update the bootstrapped environment (probably
     sufficient if installing from released packages)
   - Support for different installation targets.
   - Support a network-less installation.
   - Allow to specify the target location of the environment (default
     horde/lib)

 - Add validations (+ before release)
   - COPYING
   - Tests
   - phpDocumentor
   - Code style

 - Document usage

 - Add module for generating component documentation.

   Ideas:

   - http://pear.php.net/
   - http://components.symfony-project.org/
   - http://incubator.apache.org/zetacomponents/documentation/trunk/Mail/tutorial.html
   - http://qafoo.com/blog/011_apache_zeta_components_doing_mail_right.html
   - https://github.com/Behat/Behat-documentation/blob/master/en/Makefile [Behat docs]
   - http://sphinx.pocoo.org/intro.html

   Elements:

   - Name
   - Summary
   - Important bullet points (http://components.symfony-project.org/dependency-injection/)
   - Description
   - Changelog
   - Last Release version
   - Released versions + changes
   - Dependencies
   - Release Feed
   - Download link
   - Repo link
   - Developers (www / mail)
   - License
   - Documentation
   - Installation instructions
   - Link to mailing list
   - API doc
   - Examples
   - CI link / stats
   - Horde backlink

 - Documentation quirks:

   - <tt> not working
   - style highlighter
   - better linkage in DOCS_ORIGIN
   - template for DOCS_ORIGIN
   - ignore examples

 - WWW frontend

 - Allow absolute/relative paths as arguments

 - Allow preparing a PHAR install package

 - Debian packaging: 

   Links:

   - http://anonscm.debian.org/gitweb/?p=pkg-horde/pkg-php-tools.git;a=summary
   - http://lists.alioth.debian.org/pipermail/pkg-php-pear/2011-June/000129.html

 - General ideas / links:

   - http://blog.stuartherbert.com/php/2011/04/09/gathering-requirements-for-a-pear-channel-aggregator/
   - https://github.com/naderman/composer/blob/master/src/Composer/Composer.php
   - http://symfony2bundles.org/api
   - http://blog.astrumfutura.com/2011/06/how-would-you-engineer-a-pear2pyrus-distribution-architecture/
   - http://blog.webspecies.co.uk/2011-09-09/dependencies-management-in-php-projects.html
   - http://www.slideshare.net/naderman/composer-9206307
