Notice:
-------

You probably want to be working in git@github.com:/apache/httpd-site

Building the website:
---------------------

The CMS will build the site when a change is committed - there is no
need to build the site yourself. However, If you prefer to check the
build *before* committing, see

    http://www.apache.org/dev/cmsref#local-build


Modifying the website:
----------------------

See also http://httpd.apache.org/docs-project/docsformat.html

To modify the (staging) website, all you need to do is edit the files in the
content/ directory and then commit your changes. The format of the files is
markdown:

    http://www.apache.org/dev/cmsref#markdown

To change the look and feel of the entire website, modify the files
located in the templates/directory and commit.

To modify the links in the left side navication, edit the file
templates/navigation.mdtext and commit.

Place images in the content/images directory. When you commit, the 
modified images will be copied over and committed back to the staging tree
by the CMS.

Non-committers may use the passwordless "anonymous" account on the CMS
in conjunction with the CMS's bookmarklet to post diffs to the docs@httpd
mailing list for a committer to apply.  Simply submit your edits (sans
Quick-Commit) to the CMS, click on the provided [Diff] link, which will
provide a [Mail Diff] link.  Clicking on that, filling out the form and
submitting it will mail your changes to the provided mailing list.


Publishing on httpd.apache.org (for committers only):
-----------------------------------------------------

After you have reviewed the built changes on the staging site at

    http://httpd.staging.apache.org/

You may publish the changes to the live (httpd.apache.org) site, either by
visiting

    https://cms.apache.org/httpd/publish

or by executing the perl publication script

   % GET http://s.apache.org/cms-cli | perl

or with a proper installation located on people.apache.org:

   $ ssh -t $user@people.apache.org publish.pl httpd $user

The changes should be reflected immediately on httpd.apache.org via
the automatic svnpubsub.  If the changes don't take effect, this may
be due to the european mirror, or may be a temporary fault in svnpubsub,
inquire with infrastructure about the state of svnpubsub.


Modifying the httpd documentation:
----------------------------------

The httpd documentation - http://httpd.apache.org/docs - is managed
separately from the httpd website. Information about contributing to the
docs is available at http://httpd.apache.org/docs-project/  You should
subscribe to the docs mailing list (docs@httpd.apache.org) to discuss
changes to the docs.


Questions:
----------

If you have any questions, please subscribe to the mailing list described 
in the STATUS document.