LAYOUT
======

This document aims to describe the layout of the directory and the files
within it. If you think I've missed a file or directory, either fix it or
yell at me to fix it :-)


Directories
-----------

Directory         description
----------------- ------------------------------------------------------------------
data_files        Storage for RDF files
doap              Storage location for DOAP files we have downloaded and found to be
                  "usable".
html              Static html and cgi files needed for the output site.
    /images       Images used for the generated pages
    /styles       CSS stylesheets used by the html pages.
indexes           Directory of the indexes we are using.
scripts           Scripts that are used by the process.
       /lib       Perl libraries used by the scripts.
templates         Templates (XSLT files) we use at various stages of the process.
xdocs             Location of Xdocs2 xml files that get converted into html.
     /indexes     Index xml files (generated)
     /projects    Per project xml files (generated)

Files
-----

Filename          Description
----------------- ------------------------------------------------------------------
asfext            ???
build.xml         Ant script to run build.pl with appropriate parameters
feeds.xml         ???
files.xml         list of URL's that we should retrieve and try to use as DOAP files
HowItWorks        How it all works
LAYOUT            This file
pmc_list.xml      Details of PMCs with RDF files in data_files
projects.cg       ???
projects.xml      instructions file for Xdocs2 processing
STATUS            where it's at ...
WINDOWS           How to use the tools on Windows

doap/files.list   list of URL's and project names for the files currently in the
                  'doap' directory. This files is automatically generated and should
                  not be manually edited.
scripts/
      build.pl    The Xdocs2 generation script
      project.pl  The script that generates the indexes and xml documents. This also
                  calls the script to generate the html.