This document defines the guidelines of the xml.apache.org project. It includes definitions of the various categories of membership, who is able to vote, how conflicts are resolved by voting, and the procedures to follow for proposing and making changes to the codebase of the Project.

Note that our sister project, jakarta.apache.org, is formulating a number of other project-wide guidelines that the xml community may wish to copy or modify. In Sept-2001 there are also a number of discussions on the general@xml.apache.org and commons-dev@xml.apache.org mailing lists about other cross-project guidelines that we hope will standardize our projects and make developing and using them easier. Stay tuned!

This is a living document. Changes can be made by the Project Management Committee.

Roles and Responsibilities Defines the recognized roles in the project.
Communication Defines how users and developers communicate.
Decision Making Defines how action items are proposed and voted on.
Source Repositories Defines how the Project's source code is organized and developed.
Project Management Defines the roles and responsibilities of the Project Management Committee (PMC).
Our Mission / Charter A copy of the Charter document for the xml.apache.org Project.

As XML-oriented projects, so our website is also generated from XML files. While many similar websites may use servlets or a system like Cocoon to generate their websites on-the-fly from XML documents, we currently checkin source .xml files of the documentation and then generate a static set of .html files for most of this website.

Briefly: the entire xml.apache.org website is stored in CVS repositories. Both the source .xml documents and the generated .html docs are checked in, and the actual website itself is simply a checked-out copy of the repository.

While each subproject's individual areas may be managed separately (by that subproject's committers) the top-level of the website should be managed through the xml-site repository. Thus to change any of the files at the root of http://xml.apache.org you should first check out the xml-site repository from cvs.apache.org

(for updating the top-level docs)
Checkout the xml-site module (you only actually need a few subdirs; it's quite large)
Make updates to the .xml files in the xml-site/sources/website directory
Go to the xml-site/sources directory locally and run website.bat
Check that the .html structure in your local targets directory is built correctly
Checkin both your updated sources/ and targets/ trees as needed
Login to xml.apache.org and cd to /www/xml.apache.org
Do an update of directories there as needed