The Apache Software Foundation
The Apache Software Foundation Incubator

Overview of the Incubator site

The Incubator website is generated by the Apache CMS, but it is still using the Anakia-based page generation mechanism that was used before, triggered by a CMS external build script.

This means that you can edit the content either directly in svn (and use ant to generate and check the results), or edit via the CMS interface, but final publishing has to be done via the CMS (see below for how).

The source to the Incubator website lives at:

The incubator website is built using CMS. After changes are made, you must publish the website.

Edit the content

Help Wanted!

People with commit access to the "incubator" SVN can edit the source documents in the "content" directory. That is any ASF Member and any committer on a current podling in incubation. So you can all help to keep your project's Status page up-to-date, and if you find problems with the "guidelines" docs then can immediately fix them. If unsure, then discuss changes on the general mailing list. Note that the "policy" documents need special treatment.

Anyone else can send patches to those documents to the INCUBATOR issue tracker.

Checkout the Incubator SVN site

svn co https://svn.apache.org/repos/asf/incubator/public/trunk incubator
cd incubator

Edit the source documents

The source content is in Anakia xdoc format at the "content" directory.

Add a new document

Add new documents in the content directories, then do 'svn add'.

Generating the top-level website

Please generate the website yourself and check in the changes. If you have any problems, ask for help on the Incubator's general list.

In the top-level "incubator" SVN directory, do 'ant' to render the HTML files into the

target/site
directory. You should review those changes before committing. (If you don't have ant installed, you can run build.sh or build.bat instead.) If the site built without errors, then do the usual SVN stuff: 'svn status' 'svn add' 'svn diff' 'svn commit'.

Review your changes via the "commits" mailing list. This list will also have buildbot output from running staging builds of the website. If you want to view your changes, you can go to incubator.staging.apache.org.

To update the website, visit Publish site and fill out the form. Don't forget to give the CMS build system time to build your changes! The CMS provides a page for following the build process.

Other notes

Make sure that your subversion client is properly configured.

See other notes for maintenance of apache.org project websites.

If you are still having trouble committing, then perhaps the Subversion authorization is not yet properly configured to enable your group's access.