ApacheCon is Coming 9-12 Sept. 2019 - Las Vegas The Apache Software Foundation
Apache 20th Anniversary Logo

Celebrating 20 years of community-led development "The Apache Way"

Apache Support Logo

You can help improve this apache.org website - send in your patches to help us better explain how the ASF works!

As with all ASF projects, if you have changes to this top-level ASF documentation (/foundation/ and /dev/) then please send patches. Do that via the Infrastructure issues tracker. (Do not reveal obviously sensitive information, such as the name of any private mailing lists.) Note: PMC chairs have write access to SVN and are responsible for ensuring that the portions of the website which relate to their PMC are kept up to date.



The source code for this website managed in the SVN repository https://svn.apache.org/repos/asf/infrastructure/site/trunk
Everyone has read access. All ASF committers have write access, although you should only commit changes to areas you have responsibility for. Only ASF members or the Infrastructure team can actually publish to the live website, however.

This website uses markdown files managed by the Apache CMS tool.

To update the documentation using the CMS system

To update the documentation using only command-line tools

$ cd infrastructure/content/dev/
$ $EDITOR infra-site.mdtext
$ svn commit
... wait a short while for the page to be rebuilt ...
... **ONLY IF** you are an ASF Member, then publish: ...
$ curl -sL http://s.apache.org/cms-cli | perl

Note: the project name for the ASF website (www.apache.org) is www.

These changes should then be mirrored worldwide within a few seconds.

How The Homepage Works

The apache.org homepage itself is built from a number of different information sources and tools. The index.html itself is both static content as well as a shell that pulls in various other content bits from /index_page/. These are all static content that are used for different awareness campaigns.

The Featured Projects section is built dynamically, and rotates to show a different set of three Apache projects each time the file is checked in (it is not currently rotating live). To correct data in this section, ensure that every Apache project has:

VP, Marketing and Publicity is the formal owner of the homepage, and can be reached at press@.

What Information Is Where

The main apache.org website provides information about the ASF overall, as well as some technical information about the systems and tools that Apache projects use to build their indepenent software products.

Some useful starting points are:

Improvements to /dev documentation

The documentation at /dev/ is undergoing review and consolidation. In particular, the Infrastructure team is consolidating the underlying technical documentation about ASF systems on their website, and in the future the /dev/ path will likely be helpful end-user FAQs and pointers to the specific documentation elsewhere.

There are three main purposes for this documentation:

For the committer documentation we should have very specific documents which directly meet their needs. For the other two groups, we could have the top section of each document describing PMC tasks, while the bottom section is for Infra.