Writing documentation

We have moved writing documentation from a (cryptic and fragile) XML format to the less fragile Wiki format of Confluence. This document describes what happens after you edit or add a new page here.

Auto export

The Wiki pages for all Apache Confluence spaces are exported to a static website to ensure the scalability concerns of the Apache hardware. This is done using Pier's autoexport plugin. It uses a template for the export and this template (a Velocity file) can be applied to a space (each space can have its own export template).

The static website is found at: http://cwiki.apache.org/SPACE_NAME

After the export to cwiki.apache.org a script from Jeff Turner copies the contents of all confluence spaces to his people.apache.org home directory, found here:
http://people.apache.org/~jefft/confluence/

Now the difference kicks in: a small script (attached to the JIRA issue WICKET-25 or one of its subtasks) runs in my crontab and copies the files from Jeff's folders to our /www/incubator.apache.org

and that is it.