Index: site-author/guides/sites.xml =================================================================== --- site-author/guides/sites.xml (revision 0) +++ site-author/guides/sites.xml (revision 0) @@ -0,0 +1,66 @@ + + + + Podling Web Site Guide + + +
+ Purpose of this document +

Podlings need to build a community in Apache in order to be accepted + as part of the Apache Software Foundation. One of the tools used to build + a community is the web site.

+
+ +
+ Creating a Podling Web Site + +

Apache Project Web Sites typically include several standard pages. + Each page is formatted with a navigation bar on the left and a project + standard header that includes the Incubator graphic.

+

The Web Site can be established during incubation, and migrated + after incubation to a permanent place in the TLP home.

+ +
+ +
+ Web Site Generation Tool +

The tool used to generate the web site is the choice of the + podling members. If you already have a tool that you are comfortable + with, you can continue to use it. If you do not, consider using + anakia, a tool that processes xml to produce html.

+

Regardless of which tool you use, the web site should be maintained + in the svn repository, and include the site generation tool as a binary + file. This simplifies the process of site generation and enables changes + to the site to be made by any committer. The generated site should also + be checked into svn. This allows the generated site to be relocated + to any part of the Apache site after incubation is complete.

+

Since the site is independent of the code, it should exist high in + the svn repository, e.g. parallel to the trunk of the source tree.

+
+ + +