forrest-svn mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From cross...@apache.org
Subject svn commit: r527010 [24/26] - in /forrest/trunk/site-author/content: ./ skins/ xdocs/ xdocs/docs_0_70/ xdocs/docs_0_70/howto/ xdocs/docs_0_70/howto/bugzilla-patch/ xdocs/docs_0_70/howto/cvs-ssh/ xdocs/docs_0_70/howto/multi/ xdocs/docs_0_80/ xdocs/docs_...
Date Tue, 10 Apr 2007 03:48:57 GMT
Modified: forrest/trunk/site-author/content/xdocs/roles.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/roles.xml?view=diff&rev=527010&r1=527009&r2=527010
==============================================================================
--- forrest/trunk/site-author/content/xdocs/roles.xml (original)
+++ forrest/trunk/site-author/content/xdocs/roles.xml Mon Apr  9 20:48:52 2007
@@ -25,151 +25,202 @@
     <section id="overview">
       <title>Overview</title>
       <p>
-        There are many tasks that need to be done to keep the project flowing. With the
-        tasks being well-defined, the hope is that various people will be able to assist
-        to carry out the role and so not rely on a couple of individuals to do all the
-        work.
-      </p>
-      <p>There are no roles for "leadership" of technical areas. We don't have the
-        concept of leadership at the ASF. Rather these are "functional roles".
-      </p>
-      <p>This is not intended to put pressure on people to force them to do work nor
-        "pull their weight". If they do not manage to do a task, then someone else will
-        be able to do it. Of course, shared load means a healthy project.
-      </p>
-      <p>Most roles have minimal tasks and are not too onerous. For example, for the
-        "Documentation Coordinator", the only job might be to publish the documentation
-        every Friday. Sure it can be done at other times and other people can do it too,
-        but at least it gets done once per week.
-      </p>
-      <p>Having a person doing a role does not mean that everyone can leave it to them
-        and rely on them. Anyone else can dive in and do the job (for example, publish
-        the docs twice per week). The more people who are familiar with the role, the
-        better. Perhaps the person who is primarily doing that role will notice that
-        there can be improvements to how they are doing it.
-      </p>
-      <p>If a person is dissatisfied with the way a particular role is being done then
-        find a way to offer constructive criticism, perhaps by assisting or by
-        enhancing the role documentation.
+        There are many tasks that need to be done to keep the project flowing.
+        With the tasks being well-defined, the hope is that various people will
+        be able to assist to carry out the role and so not rely on a couple of
+        individuals to do all the work.
+      </p>
+      <p>
+        There are no roles for "leadership" of technical areas. We don't have
+        the concept of leadership at the ASF. Rather these are "functional
+        roles".
+      </p>
+      <p>
+        This is not intended to put pressure on people to force them to do work
+        nor "pull their weight". If they do not manage to do a task, then
+        someone else will be able to do it. Of course, shared load means a
+        healthy project.
+      </p>
+      <p>
+        Most roles have minimal tasks and are not too onerous. For example, for
+        the "Documentation Coordinator", the only job might be to publish the
+        documentation every Friday. Sure it can be done at other times and other
+        people can do it too, but at least it gets done once per week.
+      </p>
+      <p>
+        Having a person doing a role does not mean that everyone can leave it to
+        them and rely on them. Anyone else can dive in and do the job (for
+        example, publish the docs twice per week). The more people who are
+        familiar with the role, the better. Perhaps the person who is primarily
+        doing that role will notice that there can be improvements to how they
+        are doing it.
+      </p>
+      <p>
+        If a person is dissatisfied with the way a particular role is being done
+        then find a way to offer constructive criticism, perhaps by assisting or
+        by enhancing the role documentation.
       </p>
-      <p>Most of the roles (except of course the Developer role) can only be
+      <p>
+        Most of the roles (except of course the Developer role) can only be
         carried out by PMC members because commit access is required.
       </p>
     </section>
     <section id="roles">
       <title>The roles</title>
-      <p>These are the main roles, including the obvious ones. There are probably other
-        roles that need to be defined also. Each role should have some continually
-        enhanced documentation about it, so that any person can do the tasks.
+      <p>
+        These are the main roles, including the obvious ones. There are probably
+        other roles that need to be defined also. Each role should have some
+        continually enhanced documentation about it, so that any person can do
+        the tasks.
       </p>
       <section id="pmc-member">
         <title>PMC Member</title>
-        <p>This is well-defined in our <a href="site:guidelines">project guidelines</a>
-          and in the top-level ASF docs.
+        <p>
+          This is well-defined in our <a href="site:guidelines">project
+          guidelines</a> and in the top-level ASF docs.
         </p>
       </section>
       <section id="pmc-chair">
         <title>PMC Chair</title>
-        <p>This is well-defined in our <a href="site:guidelines">project guidelines</a>
-          and in the top-level ASF docs.
+        <p>
+          This is well-defined in our <a href="site:guidelines">project
+          guidelines</a> and in the top-level ASF docs.
         </p>
       </section>
       <section id="release-manager">
         <title>Release Manager</title>
-        <p>Tasks are defined in 
-            <a href="site:howToRelease">How to Release Forrest</a>
+        <p>
+          Tasks are defined in <a href="site:howToRelease">How to Release
+          Forrest</a>
         </p>
-        <p>Only one person can do this role, although other people can assist.
+        <p>
+          Only one person can do this role, although other people can assist.
           There is a lot of knowledge invested in this role. Document it as much
           as possible.
         </p>
       </section>
       <section id="forrest-friday-coordinator">
         <title>ForrestFriday Coordinator</title>
-        <p>The tasks are defined in
+        <p>
+          The tasks are defined in
           <a href="site:forrest-friday">ForrestFriday</a>.
         </p>
-        <p>Each month someone needs to co-ordinate the IRC session and be the main
-          channel operator, maintain the logfile and commit it to the events SVN.
-        </p>
-        <p>Ensure that the session is summarised.
-        </p>
-        <p>This role can possibly be done by someone who is not a committer. However, a
-          logfile and summary need to be committed to SVN.
+        <p>
+          Each month someone needs to co-ordinate the IRC session and be the
+          main channel operator, maintain the logfile and commit it to the
+          events SVN.
+        </p>
+        <p>
+          Ensure that the session is summarised.
+        </p>
+        <p>
+          This role can possibly be done by someone who is not a committer.
+          However, a logfile and summary need to be committed to SVN.
         </p>
       </section>
       <section id="issue-tracker-coordinator">
         <title>Issue Tracker Coordinator</title>
-        <p>Add new Components, e.g. for each new plugin.</p>
-        <p>Other general Admin tasks.</p>
-        <p>Add new committers to the forrest-administrators group.</p>
-        <p>Add/enhance <a href="site:bugs">Filters</a>.</p>
-        <p>Review issues to ensure that they are properly categorised. This is best
-          done as soon as a new issue comes in.</p>
-        <p>Review the list of unscheduled issues.</p>
-        <p>Each month get the project to review the outstanding major issues
-          that are scheduled for the upcoming release.</p>
+        <p>
+          Add new Components, e.g. for each new plugin.
+        </p>
+        <p>
+          Other general Admin tasks.
+        </p>
+        <p>
+          Add new committers to the forrest-administrators group.
+        </p>
+        <p>
+          Add/enhance <a href="site:bugs">Filters</a>.
+        </p>
+        <p>
+          Review issues to ensure that they are properly categorised. This is
+          best done as soon as a new issue comes in.
+        </p>
+        <p>
+          Review the list of unscheduled issues.
+        </p>
+        <p>
+          Each month get the project to review the outstanding major issues that
+          are scheduled for the upcoming release.
+        </p>
       </section>
       <section id="documentation-coordinator">
         <title>Documentation Coordinator</title>
-        <p>Publish the documentation at least once per week.</p>
-        <p>Various people make edits to the source files, but often the
+        <p>
+          Publish the documentation at least once per week.
+        </p>
+        <p>
+          Various people make edits to the source files, but often the
           documentation is not generated and published. Also people add new
           entries to site-author/status.xml but the changes.html needs to be
           regularly generated from it.
         </p>
-        <p>This role is not actually about doing the documentation. That should
-          be up to everyone.</p>
-        <p>Generating and publishing the main docs is very easy using a local forrestbot:
-          See 
-          <a href="site:howToPublishDocs">How to publish Forrest documentation</a>.
+        <p>
+          This role is not actually about doing the documentation. That should
+          be up to everyone.
+        </p>
+        <p>
+          Generating and publishing the main docs is very easy using a local
+          forrestbot: See <a href="site:howToPublishDocs">How to publish Forrest
+          documentation</a>.
         </p>
       </section>
       <section id="subversion-monitor">
         <title>Subversion Monitor</title>
-        <p>Ensure that svn:eol-style settings are "native" for all text files.</p>
-        <p>Ensure no line-endings issues.</p>
-        <p>Regularly run xml-tidy. (Not yet ready.)</p>
-        <p>Regularly run java-tidy. (Not yet ready.)</p>
-        <p>There are already some Perl scripts and other tools in the
+        <p>
+          Ensure that svn:eol-style settings are "native" for all text files.
+        </p>
+        <p>
+          Ensure no line-endings issues.
+        </p>
+        <p>
+          Regularly run xml-tidy. (Not yet ready.)
+        </p>
+        <p>
+          Regularly run java-tidy. (Not yet ready.)
+        </p>
+        <p>
+          There are already some Perl scripts and other tools in the
           "<a href="https://svn.apache.org/repos/private/committers">committers</a>"
           SVN in the "tools" directory.
         </p>
       </section>
       <section id="legal-monitor">
         <title>Legal Monitor</title>
-        <p>Regularly run a script which verifies and inserts missing license
+        <p>
+          Regularly run a script which verifies and inserts missing license
           headers to source files.
         </p>
-  
-        <p>Regularly ensure that there are appropriate matching licenses to
+        <p>
+          Regularly ensure that there are appropriate matching licenses to
           accompany each supporting product that we redistribute.
         </p>
-  
-        <p>This should have continual oversight by the PMC as a whole, but the
-          monitoring is something that needs to be done regularly, and definitely
-          prior to each release.
+        <p>
+          This should have continual oversight by the PMC as a whole, but the
+          monitoring is something that needs to be done regularly, and
+          definitely prior to each release.
         </p>
-  
-        <p>There are already some Perl scripts and other tools in the
+        <p>
+          There are already some Perl scripts and other tools in the
           "<a href="https://svn.apache.org/repos/private/committers">committers</a>"
           SVN in the "tools" and "relicense/src/perl" directories.
         </p>
       </section>
       <section id="developer">
         <title>Developer</title>
-        <p>The above roles are only for PMC Members. How can the Developers be
+        <p>
+          The above roles are only for PMC Members. How can the Developers be
           involved? That is easy: do the Developer Role.
         </p>
-  
-        <p>Help out with commenting on the Issue Tracker, fixing the issues,
+        <p>
+          Help out with commenting on the Issue Tracker, fixing the issues,
           contributing to discussion, contributing patches, turning discussion
           into clear documentation.
         </p>
-  
-        <p>This is incredibly valuable and will enable the project to grow.
-          After time, you will probably be elected as Committer/PMC Member and
-          when comfortable, can take on one of the Project Management Roles.
+        <p>
+          This is incredibly valuable and will enable the project to grow. After
+          time, you will probably be elected as Committer/PMC Member and when
+          comfortable, can take on one of the Project Management Roles.
         </p>
       </section>
     </section>

Modified: forrest/trunk/site-author/content/xdocs/site.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/site.xml?view=diff&rev=527010&r1=527009&r2=527010
==============================================================================
--- forrest/trunk/site-author/content/xdocs/site.xml (original)
+++ forrest/trunk/site-author/content/xdocs/site.xml Mon Apr  9 20:48:52 2007
@@ -16,8 +16,7 @@
   limitations under the License.
 -->
 <site label="Forrest" href="" xmlns="http://apache.org/forrest/linkmap/1.0" tab="home">
-
-  <!-- General documentation that applies to all versions -->
+<!-- General documentation that applies to all versions -->
   <about label="About">
     <index label="About Forrest" href="index.html" description="Welcome and introduction"/>
     <linkmap label="Documentation ToC" href="linkmap.html" description="Table of Contents for all Forrest documentation"/>
@@ -31,18 +30,17 @@
     <compliance label="Standards compliance" href="compliance.html"
       description="Declare the status of HTML, WAI, CSS compliance"/>
     <forrest-issues label="Open issues" href="forrest-issues.html"
-      description="List of currently open issues"/> 
+      description="List of currently open issues"/>
     <who label="Who we are" href="who.html" description="Explain who is involved"/>
     <flyer label="Flyer" href="flyer.html" description="One-page description"/>
     <live-sites label="Example sites" href="live-sites.html"
       description="Some sites created using Apache Forrest technology"/>
     <thanks label="Thanks" href="thanks.html"
-      description="Acknowledgment to those who have become involved"/> 
-    <!-- Entry with no @label causes correct Tab to be selected.
+      description="Acknowledgment to those who have become involved"/>
+<!-- Entry with no @label causes correct Tab to be selected.
       Also enables additional page to be generated. -->
     <download_html href="mirrors.html"/>
   </about>
-  
   <getting-involved label="Getting involved" tab="project">
     <contrib label="Contributing" href="contrib.html"
       description="Everyone is a developer and has something to contribute">
@@ -65,7 +63,6 @@
       <roles label="Project roles" href="roles.html" description="Tasks to keep the project flowing"/>
     </project>
   </getting-involved>
-    
   <infrastructure label="Resources and Infrastructure" tab="project"
     description="Tools and services that help us do our work">
     <overview label="Introduction" href="asf-infrastructure.html"
@@ -88,40 +85,37 @@
       <internal-xhtml label="Internal XHTML" href="internal-xhtml.html"/>
     </plan>
     <todo label="Todo" href="todo.html"/>
-  </infrastructure>  
-    
-    <procedures label="Best Practices and Procedures" tab="project"
+  </infrastructure>
+  <procedures label="Best Practices and Procedures" tab="project"
       description="Procedures and best practices for common tasks">
-      <forrest-dev label="Development tips" href="howto-dev.html"
-      description="Describes tips and procedures for efficiently developing with Forrest.">  
-        <sitemap href="#sitemap"/>
-        <debug href="#debug"/>
-        <debug-cocoon-profiler href="#debug-cocoon-profiler"/>
-        <debug-modes href="#debug-modes"/>
-        <debug-sitemap-exec href="#debug-sitemap-exec"/>
-        <debug-validation href="#debug-validation"/>
-      </forrest-dev>
-      <svnBP label="Subversion" href="subversion_bestpractices.html"
+    <forrest-dev label="Development tips" href="howto-dev.html"
+      description="Describes tips and procedures for efficiently developing with Forrest.">
+      <sitemap href="#sitemap"/>
+      <debug href="#debug"/>
+      <debug-cocoon-profiler href="#debug-cocoon-profiler"/>
+      <debug-modes href="#debug-modes"/>
+      <debug-sitemap-exec href="#debug-sitemap-exec"/>
+      <debug-validation href="#debug-validation"/>
+    </forrest-dev>
+    <svnBP label="Subversion" href="subversion_bestpractices.html"
         description="Best practice notes for Subversion"/>
-      <docsBP label="Documentation" href="documentation_bestpractices.html"
+    <docsBP label="Documentation" href="documentation_bestpractices.html"
         description="Best practice notes for documentation"/>
-      <write-howto label="Write a How-to" href="howto-howto.html"
+    <write-howto label="Write a How-to" href="howto-howto.html"
         description="Instructions for writing
             a new howto-document"/>
-      <committers label="Committer notes">
-        <zoneMangement label="Zone management" href="zone.html"
+    <committers label="Committer notes">
+      <zoneMangement label="Zone management" href="zone.html"
           description="Notes for committers to manage forrest.zones.apache.org"/>
-        <howToRelease label="How to release" href="procedures/release/How_to_release.html"
+      <howToRelease label="How to release" href="procedures/release/How_to_release.html"
           description="Instructions on preparing and creating a new Forrest release."/>
-        <howToPublishDocs label="Publishing Forrest documentation" href="procedures/How_to_publish_docs.html" description="Instructions on publishing the Forrest
+      <howToPublishDocs label="Publishing Forrest documentation" href="procedures/How_to_publish_docs.html" description="Instructions on publishing the Forrest
             Website"/>
-      </committers>
-    </procedures>
-
+    </committers>
+  </procedures>
   <proposals label="Proposals" tab="project">
     <asf-forrestbot label="ASF Forrestbot" href="proposal-asf-forrestbot.html"/>
   </proposals>
-
   <references label="Related projects">
     <gump label="Apache Gump" href="http://gump.apache.org/"/>
     <cocoon label="Apache Cocoon" href="http://cocoon.apache.org/"/>
@@ -129,14 +123,12 @@
     <xml label="Apache XML" href="http://xml.apache.org/"/>
     <pao label="projects.apache.org" href="http://projects.apache.org/"/>
   </references>
-
-  <!-- Uncomment this if we want aggregate HTML/PDFs for this site 
+<!-- Uncomment this if we want aggregate HTML/PDFs for this site 
   <pdfs label="PDFs">
     <whole_site_html label="Whole site HTML" href="wholesite.html"/>
     <whole_site_pdf label="Whole site PDF" href="wholesite.pdf"/>
   </pdfs>
   -->
-
   <external-refs>
     <asf href="http://www.apache.org/">
       <asl href="licenses/"/>
@@ -155,24 +147,20 @@
       <file-url href="userdocs/concepts/sitemap.html#file-url"/>
       <input-modules href="userdocs/concepts/modules.html"/>
       <views href="userdocs/concepts/views.html"/>
-        
     </cocoon>
-
     <forrest href="http://forrest.apache.org/">
       <download href="mirrors.cgi"/>
       <docs href="docs/">
 <!-- FIXME: Might not need these when we have the local docs happening -->
-         <versions>
-           <overview href="../docs.html"/>
-           <v0.8 href="../0.8/"/>
-           <v0.7 href="../0.7/"/>
-           <v0.6 href="../0.6/"/>
-         </versions>
+        <versions>
+          <overview href="../docs.html"/>
+          <v0.8 href="../0.8/"/>
+          <v0.7 href="../0.7/"/>
+          <v0.6 href="../0.6/"/>
+        </versions>
       </docs>
     </forrest>
-    <forrest-zone href="http://forrest.zones.apache.org/">
-    </forrest-zone>
-    
+    <forrest-zone href="http://forrest.zones.apache.org/"></forrest-zone>
     <java href="http://java.sun.com/">
       <j2ee href="j2ee/">
         <patterns href="patterns/">
@@ -189,7 +177,6 @@
         <dispatcherView href="DispatcherView.htm" />
       </patterns>
     </corej2eepatterns>
-
     <xml.apache.org href="http://xml.apache.org/">
       <commons href="commons/">
         <resolver href="components/resolver/"/>
@@ -206,13 +193,11 @@
     <ant href="http://ant.apache.org/"/>
     <gump href="http://gump.apache.org/"/>
     <lenya href="http://lenya.apache.org/"/>
-
     <cool-uris href="http://www.w3.org/Provider/Style/URI.html"/>
     <uri-rfc href="http://zvon.org/tmRFC/RFC2396/Output/index.html"/>
     <catalog_spec href="http://www.oasis-open.org/committees/entity/spec.html"/>
 <!--<catalog_spec href="http://www.oasis-open.org/committees/entity/background/9401.html"/>-->
     <catalog_intro href="http://xml.apache.org/commons/components/resolver/resolver-article.html"/>
-
     <mail>
       <linkmaps href="http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=103444028129281&amp;w=2"/>
       <semantic-linking href="http://marc.theaimsgroup.com/?l=forrest-dev&amp;m=103097808318773&amp;w=2"/>
@@ -221,20 +206,17 @@
       <linkrewritertransformer href="http://issues.apache.org/bugzilla/show_bug.cgi?id=15611"/>
     </mail>
   </external-refs>
-
   <versions tab="docs">
     <overview label="Overview" href="versions/index.html"/>
     <v0.8 label="0.8-dev" href="site:index"/>
     <v0.7 label="0.7 (current)" href="site:v0.70//index"/>
     <v0.6 label="0.6" href="site:v0.60//index"/>
   </versions>
-  
   <pluginVersions tab="plugins">
     <overview label="Overview" href="pluginDocs/index.html"/>
     <v0.8 label="0.8-dev" href="site:plugins/index"/>
     <v0.7 label="0.7 (current)" href="site:v0.70//plugins/index"/>
   </pluginVersions>
-
   <tools label="Tools" href="tools/" tab="tools">
     <index label="Index" href="index.html"/>
     <forrestbar label="ForrestBar" href="forrestbar.html"/>
@@ -243,10 +225,7 @@
     <eclipse label="Eclipse Plugin" href="eclipse.html"/>
     <xxe label="XXE-Editor" href="xxe.html"/>
   </tools>
-
-    
-    
-  <!-- Versioned Documentation
+<!-- Versioned Documentation
        
        The surrounding version number element allows linking to a specific
        version of a document with the site:protocol by specifiying an access 
@@ -259,371 +238,324 @@
        -  FIXME: Add instructions for fixing directories and adjusting links in files  
        
        -->
-  
-    
-      
-    <v0.80 label="Documentation in development" description="Set of documents for the in-development version, i.e. SVN head">
-      <documentation label="0.80-dev" tab="v0_80" href="docs_0_80/">
-        <index label="Overview" href="index.html"/>
-          <!-- FIXME: Needed to avoid moving files -->
-          <catalog href="catalog.html"/>
-          <project-sitemap href="project-sitemap.html"/>
-          <upgrading_08 href="upgrading_08.html"/>
-        <!-- Insert all instructional documentation here -->
-        <your-project label="Using Forrest" href="your-project.html">
-            <new_content_type href="#adding_new_content_type"/>
-            <new_dtd href="#new_dtd"/>
-            <webapp href="#webapp"/>
-            <skins href="#skins"/>
-            <new-skin href="#new_skin"/>
-            <invoking_from_ant href="#invoking_from_ant"/>
-        </your-project> 
-        <howto label="How-To" href="howto/">
-            <overview label="Overview" href="index.html"/>
-            <ForrestInstall label="Install Forrest">
-                <build label="Building Forrest from Source" href="../build.html" description="Build and install the current
+  <v0.80 label="Documentation in development" description="Set of documents for the in-development version, i.e. SVN head">
+    <documentation label="0.80-dev" tab="v0_80" href="docs_0_80/">
+      <index label="Overview" href="index.html"/>
+<!-- FIXME: Needed to avoid moving files -->
+      <catalog href="catalog.html"/>
+      <project-sitemap href="project-sitemap.html"/>
+      <upgrading_08 href="upgrading_08.html"/>
+<!-- Insert all instructional documentation here -->
+      <your-project label="Using Forrest" href="your-project.html">
+        <new_content_type href="#adding_new_content_type"/>
+        <new_dtd href="#new_dtd"/>
+        <webapp href="#webapp"/>
+        <skins href="#skins"/>
+        <new-skin href="#new_skin"/>
+        <invoking_from_ant href="#invoking_from_ant"/>
+      </your-project>
+      <howto label="How-To" href="howto/">
+        <overview label="Overview" href="index.html"/>
+        <ForrestInstall label="Install Forrest">
+          <build label="Building Forrest from Source" href="../build.html" description="Build and install the current
                     unreleased version">
-                    <run href="#run"/>
-                </build>
-            </ForrestInstall>
-            <upgrading_08Ref label="Upgrading to 0.8" href="site:upgrading_08"/>
-            
-            <ForrestUse label="Use Forrest">
-                
-            </ForrestUse>
-            
-            <ForrestCustomize label="Customize Forrest" description="Adapt and tune Forrest for your needs">
-                <sitemap-explain label="Sitemaps explained" href="../sitemap-explain.html"/>
-                <custom-html-source label="Custom html source" href="howto-custom-html-source.html"/>
-                <project-sitemapRef label="Project sitemap" href="site:project-sitemap"/>
-                
-                <editcss label="Edit CSS (WYSIWYG)" href="howto-editcss.html"/>
-                
-                <pdf-tab label="Create tab PDF" href="howto-pdf-tab.html" 
-                    description="Generate one pdf-document for all pages of a tab"/>
-                <corner-css label="CSS corner SVG" href="howto-corner-images.html"/>
-            </ForrestCustomize>
-                
-            <ForrestIntegrate label="Integrate Forrest with tools">
-                <maven label="Maven Integration" href="howto-forrest-from-maven.html"/>
-                <catalogRef1 label="Using DTD Catalogs" href="site:catalog"/>   
-            </ForrestIntegrate>
-            
-            <ForrestExtend label="Extend Forrest" description="Extend Forrest with new functionalities">
-                <buildPlugin label="Build a Plugin" href="howto-buildPlugin.html"/>
-                <skin-package label="Package new Skins" href="../skin-package.html"/>
-            </ForrestExtend>
-            
-            <asf-mirror label="Download mirror" href="howto-asf-mirror.html"/>
-            
-            <documentationCreate label="Adding Documentation" description="Instructions to enhance Forrest by writing
-                new pieces of documentation.">
-                <write-howto label="Write a How-to" href="site:write-howto" description="Instructions for writing
-                a new howto-document"/>
-                <multi label="Multipage HowTo" href="multi/">
-                    <intro label="Introduction" href="howto-multi.html"/>
-                    <step1 label="Step 1" href="step1.html"/>
-                    <step2 label="Step 2" href="step2.html"/>
-                    <step3 label="Step 3" href="step3.html"/>
-                </multi>
-            </documentationCreate>
-            
-          </howto>  
-
-        <faq label="FAQs" href="faq.html">
-          <build_msg_a href="#build_msg_a"/>
-          <docbook href="#docbook"/>
-          <docs href="#docs"/>
-          <checksums href="#checksums"/>
-          <edit-content href="#edit-content"/>
-          <ignoring_javadocs href="#ignoring_javadocs"/>
-          <jobs href="#jobs"/>
-          <link_raw href="#link_raw"/>
-          <logs href="#logs"/>
-          <pdf_images href="#pdf_images"/>
-          <rawHTML href="#rawHTML"/>
-          <single-document href="#single-document"/>
-          <tab-index href="#tab-index"/>
-          <cli-xconf href="#cli-xconf"/>
-          <pageBreaks href="#pageBreaks"/>
-          <site-xml href="#site-xml"/>
-          <requirements href="#requirements"/>
-          <xml-entities href="#xml-entities"/>
-        </faq>
-          
-          <whitepapers label="Background" description="Background documentation about Forrest and the technologies used">
-              
-             <linking label="Menus and Linking" href="linking.html">
-              
-             <menu_generation href="#menu_generation"/>
-                 <tab-site href="#tab-site"/>
-             </linking>
-              <searching label="Search Options in Forrest" href="searching.html"/>   
-             <locationmap label="Locationmap" href="locationmap.html">
-               <namingConvention href="#namingConvention"/>
-             </locationmap>
-              <sitemap-ref label="Sitemap Reference" href="sitemap-ref.html">
-                  <linkrewriting_impl href="#linkrewriting_impl"/>
-                  <menu_generation_impl href="#menu_generation_impl"/>
-                  <source_pipelines href="#source_pipelines"/>
-                  <forrest_xmap href="#forrest_xmap"/>
-              </sitemap-ref>
-              <skins label="Skins" href="skins.html" description="About default skins, their naming and features"/>
-              <status-themes label="Dispatcher versus Skins" href="status-themes.html"/>
-              <cap label="Sourcetype Action" href="cap.html"/>
-              <validation label="XML validation and entity resolution" href="validation.html">
-                <catalog href="#catalog"/>
-                <debug-catalog href="#debug-catalog"/>
-              </validation>
-         </whitepapers>
-          
-         
-          
-        <changes label="Changes" href="changes.html"/>
-        <changes-rss href="changes.rss"/>
-        
-        
-        
-        <glossary label="Glossary" href="glossary.html"/>
-        
-        
-        
-        
-        
- 
-        <samples label="Reference docs">
-          <dtd-docs-container label="DTD documentation">
-            <dtd-docs label="Overview" href="../dtdx/dtd-docs.html"/>
-            <document-v20-dtd label="document-v20" href="../dtdx/document-v20.dtdx.html"/>
-            <howto-v20-dtd label="howto-v20" href="../dtdx/howto-v20.dtdx.html"/>
-            <faq-v20-dtd label="faq-v20" href="../dtdx/faq-v20.dtdx.html"/>
-            <document-v13-dtd label="document-v13" href="../dtdx/document-v13.dtdx.html"/>
-            <howto-v13-dtd label="howto-v13" href="../dtdx/howto-v13.dtdx.html"/>
-            <faq-v13-dtd label="faq-v13" href="../dtdx/faq-v13.dtdx.html"/>
-          </dtd-docs-container>
-          <samples-container label="Doc samples">
-            <document-v12 href="../dtdx/document-v12.html"/>
-            <document-v13 label="document-v13" href="../dtdx/document-v13.html"/>
-            <document-v20 label="document-v20" href="../dtdx/document-v20.html"/>
-          </samples-container>
-        </samples>
-        
-        <!-- FIXME: Consider moving these documents into their own tab as there is no point in
-                    coying historic info from version to version.
-                    Options: Subtab "Old Stuff" in Docs tab or as a main tab 
-        -->
-        <older_documentation label="Older Docs">
-          <primer label="Forrest Primer" href="primer.html">
-            <cvs href="#cvs"/>
-          </primer>
-          <libre-intro label="Libre" href="libre-intro.html"/>
-          <dreams label="Dream list" href="dreams.html"/>
-          <cvsssh label="CVS over SSH" href="howto/cvs-ssh/howto-cvs-ssh.html"/>
-        </older_documentation>
-      </documentation>
-
-      <plugins label="0.80 Plugins" href="pluginDocs/plugins_0_80/" tab="p0_80">
-        <index label="Index" href="index.html"/>
-        <using label="Using Plugins" href="usingPlugins.html"/>
-        <infrastructure label="Plugin Infrastructure" href="pluginInfrastructure.html"/>
-      </plugins>
-    </v0.80>
-
-    <v0.70 label="Documentation current" description="Set of documents for the released version">
-      <documentation label="0.70" tab="v0_70" href="docs_0_70/">
-        <index label="Overview" href="index.html"/>
-        <faq label="FAQs" href="faq.html">
-          <docbook href="#docbook"/>
-          <ignoring_javadocs href="#ignoring_javadocs"/>
-          <link_raw href="#link_raw"/>
-          <pdf_images href="#pdf_images"/>
-          <tab-index href="#tab-index"/>
-          <cli-xconf href="#cli-xconf"/>
-          <pageBreaks href="#pageBreaks"/>
-          <site-xml href="#site-xml"/>
-          <requirements href="#requirements"/>
-        </faq>
-        <changes label="Changes" href="changes.html"/>
-        <changes-rss href="changes.rss"/>
-        <todo label="Todo" href="todo.html"/>
-        <your-project label="Using Forrest" href="your-project.html">
-          <new_content_type href="#adding_new_content_type"/>
-          <new_dtd href="#new_dtd"/>
-          <webapp href="#webapp"/>
-          <skins href="#skins"/>
-          <new-skin href="#new_skin"/>
-          <invoking_from_ant href="#invoking_from_ant"/>
-        </your-project>
-        <validation label="XML Validation" href="validation.html"/>
-        <linking label="Menus and Linking" href="linking.html">
-          <menu_generation href="#menu_generation"/>
-          <tab-site href="#tab-site"/>
-        </linking>
-        <searching label="Searching" href="searching.html"/>
-        <skins label="Default Skins" href="skins.html"/>
-        <skin-package label="Skin Packages" href="skin-package.html"/>
-        <views label="Views-dev" href="views.html"/>
-
-        <forrest-contract label="Our Contract" href="forrest-contract.html"/>
-        <compliance label="Standards Compliance" href="compliance.html"/>
-        
-        <howto label="How-To" href="howto/">
-          <overview label="Overview" href="index.html"/>
-          <write-howto label="Write a How-to" href="howto-howto.html"/>
-          <asf-mirror label="Download mirror" href="howto-asf-mirror.html"/>
-          <pdf-tab label="Create tab PDF" href="howto-pdf-tab.html"/>
+            <run href="#run"/>
+          </build>
+        </ForrestInstall>
+        <upgrading_08Ref label="Upgrading to 0.8" href="site:upgrading_08"/>
+        <ForrestUse label="Use Forrest"></ForrestUse>
+        <ForrestCustomize label="Customize Forrest" description="Adapt and tune Forrest for your needs">
+          <sitemap-explain label="Sitemaps explained" href="../sitemap-explain.html"/>
+          <custom-html-source label="Custom html source" href="howto-custom-html-source.html"/>
+          <project-sitemapRef label="Project sitemap" href="site:project-sitemap"/>
           <editcss label="Edit CSS (WYSIWYG)" href="howto-editcss.html"/>
+          <pdf-tab label="Create tab PDF" href="howto-pdf-tab.html" 
+                    description="Generate one pdf-document for all pages of a tab"/>
           <corner-css label="CSS corner SVG" href="howto-corner-images.html"/>
+        </ForrestCustomize>
+        <ForrestIntegrate label="Integrate Forrest with tools">
           <maven label="Maven Integration" href="howto-forrest-from-maven.html"/>
+          <catalogRef1 label="Using DTD Catalogs" href="site:catalog"/>
+        </ForrestIntegrate>
+        <ForrestExtend label="Extend Forrest" description="Extend Forrest with new functionalities">
           <buildPlugin label="Build a Plugin" href="howto-buildPlugin.html"/>
-          <custom-html-source label="Custom html source" href="howto-custom-html-source.html"/>
+          <skin-package label="Package new Skins" href="../skin-package.html"/>
+        </ForrestExtend>
+        <asf-mirror label="Download mirror" href="howto-asf-mirror.html"/>
+        <documentationCreate label="Adding Documentation" description="Instructions to enhance Forrest by writing
+                new pieces of documentation.">
+          <write-howto label="Write a How-to" href="site:write-howto" description="Instructions for writing
+                a new howto-document"/>
           <multi label="Multipage HowTo" href="multi/">
             <intro label="Introduction" href="howto-multi.html"/>
             <step1 label="Step 1" href="step1.html"/>
             <step2 label="Step 2" href="step2.html"/>
             <step3 label="Step 3" href="step3.html"/>
           </multi>
-          <view label="Views">
-            <install label="Install views" href="howto-view-install.html"/>
-            <DSL label="forrest:view DSL" href="howto-view-dsl.html"/>
-            <contracts label="contract implementations" href="howto-view-contracts.html"/>
-          </view>
-        </howto>
-        
-        <developers label="Advanced Topics">
-          <build label="Building Forrest" href="build.html">
-            <run href="#run"/>
-          </build>
-          <catalog label="Using DTD Catalogs" href="catalog.html"/>
-          <sitemap-ref label="Sitemap Reference" href="sitemap-ref.html">
-            <linkrewriting_impl href="#linkrewriting_impl"/>
-            <menu_generation_impl href="#menu_generation_impl"/>
-            <source_pipelines href="#source_pipelines"/>
-            <forrest_xmap href="#forrest_xmap"/>
-          </sitemap-ref>
-          <project-sitemap label="Project sitemap" href="project-sitemap.html"/>
-          <cap label="Sourcetype Action" href="cap.html"/>
-        </developers>
-        
-        <upgrading_07 label="Upgrading to 0.7" href="upgrading_07.html">
-          <raw href="#raw"/>
-        </upgrading_07>
- 
-        <samples label="Reference docs">
-          <dtd-docs-container label="DTD documentation">
-            <dtd-docs label="Overview" href="../dtdx/dtd-docs.html"/>
-            <document-v20-dtd label="document-v20" href="../dtdx/document-v20.dtdx.html"/>
-            <howto-v20-dtd label="howto-v20" href="../dtdx/howto-v20.dtdx.html"/>
-            <faq-v20-dtd label="faq-v20" href="../dtdx/faq-v20.dtdx.html"/>
-            <document-v13-dtd label="document-v13" href="../dtdx/document-v13.dtdx.html"/>
-            <howto-v13-dtd label="howto-v13" href="../dtdx/howto-v13.dtdx.html"/>
-            <faq-v13-dtd label="faq-v13" href="../dtdx/faq-v13.dtdx.html"/>
-          </dtd-docs-container>
-          <samples-container label="Doc samples">
-            <document-v12 href="../dtdx/document-v12.html"/>
-            <document-v13 label="document-v13" href="../dtdx/document-v13.html"/>
-            <document-v20 label="document-v20" href="../dtdx/document-v20.html"/>
-          </samples-container>
-        </samples>
-        
-        <!-- FIXME: Consider moving these documents into their own tab as there is no point in
-                    coying historic info from version to version.
-                    Options: Subtab "Old Stuff" in Docs tab or as a main tab 
-        -->
-        <older_documentation label="Older Docs">
-          <primer label="Forrest Primer" href="primer.html">
-            <cvs href="#cvs"/>
-          </primer>
-          <libre-intro label="Libre" href="libre-intro.html"/>
-          <dreams label="Dream list" href="dreams.html"/>
-          <cvsssh label="CVS over SSH" href="howto/cvs-ssh/howto-cvs-ssh.html"/>
-        </older_documentation>
-      </documentation>
-
-      <plugins label="0.70 Plugins" href="pluginDocs/plugins_0_70/" tab="p0_70">
-        <index label="Index" href="index.html"/>
-        <using label="Using Plugins" href="usingPlugins.html"/>
-        <infrastructure label="Plugin Infrastructure" href="pluginInfrastructure.html"/>
-      </plugins>
-    </v0.70>
-
-    <v0.60>
-      <documentation label="0.60" href="docs_0_60/" tab="v0_60">
-        <index label="Overview" href="index.html"/>
-        <faq label="FAQs" href="faq.html">
-          <docbook href="#docbook"/>
-          <ignoring_javadocs href="#ignoring_javadocs"/>
-          <link_raw href="#link_raw"/>
-          <pdf_images href="#pdf_images"/>
-        </faq>
-        <changes label="Changes" href="changes.html"/>
-        <todo label="Todo" href="todo.html"/>
-        <your-project label="Using Forrest" href="your-project.html">
-          <new_content_type href="#adding_new_content_type"/>
-          <new_dtd href="#new_dtd"/>
-          <webapp href="#webapp"/>
-          <skins href="#skins"/>
-          <new-skin href="#new_skin"/>
-          <invoking_from_ant href="#invoking_from_ant"/>
-        </your-project>
-        <upgrading_06 label="Upgrading to 0.6" href="upgrading_06.html"/>
-        <validation label="XML Validation" href="validation.html"/>
+        </documentationCreate>
+      </howto>
+      <faq label="FAQs" href="faq.html">
+        <build_msg_a href="#build_msg_a"/>
+        <docbook href="#docbook"/>
+        <docs href="#docs"/>
+        <checksums href="#checksums"/>
+        <edit-content href="#edit-content"/>
+        <ignoring_javadocs href="#ignoring_javadocs"/>
+        <jobs href="#jobs"/>
+        <link_raw href="#link_raw"/>
+        <logs href="#logs"/>
+        <pdf_images href="#pdf_images"/>
+        <rawHTML href="#rawHTML"/>
+        <single-document href="#single-document"/>
+        <tab-index href="#tab-index"/>
+        <cli-xconf href="#cli-xconf"/>
+        <pageBreaks href="#pageBreaks"/>
+        <site-xml href="#site-xml"/>
+        <requirements href="#requirements"/>
+        <xml-entities href="#xml-entities"/>
+      </faq>
+      <whitepapers label="Background" description="Background documentation about Forrest and the technologies used">
         <linking label="Menus and Linking" href="linking.html">
           <menu_generation href="#menu_generation"/>
+          <tab-site href="#tab-site"/>
         </linking>
-        <searching label="Searching" href="searching.html"/>
-        <skins label="Default Skins" href="skins.html"/>
-        <skin-package label="Skin Packages" href="skin-package.html"/>
-        
-        <forrest-contract label="Our Contract" href="forrest-contract.html"/>
-        <compliance label="Standards Compliance" href="compliance.html"/>
-        
-        <howto label="How-To" href="howto/">
-          <overview label="Overview" href="index.html"/>
-          <single-page label="Single Page" href="howto-howto.html"/>
-          <multi-page label="Multi-Page" href="multi/">
-            <intro label="Intro" href="howto-multi.html"/>
-            <step1 label="Step 1" href="step1.html"/>
-            <step2 label="Step 2" href="step2.html"/>
-            <step3 label="Step 3" href="step3.html"/>
-          </multi-page>
-          <with-images label="With Images" href="bugzilla-patch/howto-bugzilla-patch.html"/>
-          <write-howto label="Write a How-to" href="howto-howto.html"/>
-          <asf-mirror label="Download mirror" href="howto-asf-mirror.html"/>
-          <pdf-tab label="Create tab PDF" href="howto-pdf-tab.html"/>
-        </howto>
-        
-        <developers label="Advanced Topics">
-          <build label="Building Forrest" href="build.html"/>
-          <catalog label="Using DTD Catalogs" href="catalog.html"/>
-          <sitemap-ref label="Sitemap Reference" href="sitemap-ref.html">
-            <linkrewriting_impl href="#linkrewriting_impl"/>
-            <menu_generation_impl href="#menu_generation_impl"/>
-            <source_pipelines href="#source_pipelines"/>
-            <forrest_xmap href="#forrest_xmap"/>
-          </sitemap-ref>
-          <project-sitemap label="Project sitemap" href="project-sitemap.html"/>
-          <cap label="Sourcetype Action" href="cap.html"/>
-        </developers>
-        
-        <samples label="Reference docs">
-          <dtd-docs-container label="DTD documentation">
-            <dtd-docs label="Overview" href="../dtdx/dtd-docs.html"/>
-            <document-v20-dtd label="document-v20" href="../dtdx/document-v20.dtdx.html"/>
-            <howto-v20-dtd label="howto-v20" href="../dtdx/howto-v20.dtdx.html"/>
-            <faq-v20-dtd label="faq-v20" href="../dtdx/faq-v20.dtdx.html"/>
-            <document-v13-dtd label="document-v13" href="../dtdx/document-v13.dtdx.html"/>
-            <howto-v13-dtd label="howto-v13" href="../dtdx/howto-v13.dtdx.html"/>
-            <faq-v13-dtd label="faq-v13" href="../dtdx/faq-v13.dtdx.html"/>
-          </dtd-docs-container>
-          <samples-container label="Doc samples">
-            <document-v12 href="../dtdx/document-v12.html"/>
-            <document-v13 label="document-v13" href="../dtdx/document-v13.html"/>
-            <document-v20 label="document-v20" href="../dtdx/document-v20.html"/>
-          </samples-container>
-        </samples>
-      </documentation>
-    </v0.60>
-
-    
+        <searching label="Search Options in Forrest" href="searching.html"/>
+        <locationmap label="Locationmap" href="locationmap.html">
+          <namingConvention href="#namingConvention"/>
+        </locationmap>
+        <sitemap-ref label="Sitemap Reference" href="sitemap-ref.html">
+          <linkrewriting_impl href="#linkrewriting_impl"/>
+          <menu_generation_impl href="#menu_generation_impl"/>
+          <source_pipelines href="#source_pipelines"/>
+          <forrest_xmap href="#forrest_xmap"/>
+        </sitemap-ref>
+        <skins label="Skins" href="skins.html" description="About default skins, their naming and features"/>
+        <status-themes label="Dispatcher versus Skins" href="status-themes.html"/>
+        <cap label="Sourcetype Action" href="cap.html"/>
+        <validation label="XML validation and entity resolution" href="validation.html">
+          <catalog href="#catalog"/>
+          <debug-catalog href="#debug-catalog"/>
+        </validation>
+      </whitepapers>
+      <changes label="Changes" href="changes.html"/>
+      <changes-rss href="changes.rss"/>
+      <glossary label="Glossary" href="glossary.html"/>
+      <samples label="Reference docs">
+        <dtd-docs-container label="DTD documentation">
+          <dtd-docs label="Overview" href="../dtdx/dtd-docs.html"/>
+          <document-v20-dtd label="document-v20" href="../dtdx/document-v20.dtdx.html"/>
+          <howto-v20-dtd label="howto-v20" href="../dtdx/howto-v20.dtdx.html"/>
+          <faq-v20-dtd label="faq-v20" href="../dtdx/faq-v20.dtdx.html"/>
+          <document-v13-dtd label="document-v13" href="../dtdx/document-v13.dtdx.html"/>
+          <howto-v13-dtd label="howto-v13" href="../dtdx/howto-v13.dtdx.html"/>
+          <faq-v13-dtd label="faq-v13" href="../dtdx/faq-v13.dtdx.html"/>
+        </dtd-docs-container>
+        <samples-container label="Doc samples">
+          <document-v12 href="../dtdx/document-v12.html"/>
+          <document-v13 label="document-v13" href="../dtdx/document-v13.html"/>
+          <document-v20 label="document-v20" href="../dtdx/document-v20.html"/>
+        </samples-container>
+      </samples>
+<!-- FIXME: Consider moving these documents into their own tab as there is no point in
+                    coying historic info from version to version.
+                    Options: Subtab "Old Stuff" in Docs tab or as a main tab 
+        -->
+      <older_documentation label="Older Docs">
+        <primer label="Forrest Primer" href="primer.html">
+          <cvs href="#cvs"/>
+        </primer>
+        <libre-intro label="Libre" href="libre-intro.html"/>
+        <dreams label="Dream list" href="dreams.html"/>
+        <cvsssh label="CVS over SSH" href="howto/cvs-ssh/howto-cvs-ssh.html"/>
+      </older_documentation>
+    </documentation>
+    <plugins label="0.80 Plugins" href="pluginDocs/plugins_0_80/" tab="p0_80">
+      <index label="Index" href="index.html"/>
+      <using label="Using Plugins" href="usingPlugins.html"/>
+      <infrastructure label="Plugin Infrastructure" href="pluginInfrastructure.html"/>
+    </plugins>
+  </v0.80>
+  <v0.70 label="Documentation current" description="Set of documents for the released version">
+    <documentation label="0.70" tab="v0_70" href="docs_0_70/">
+      <index label="Overview" href="index.html"/>
+      <faq label="FAQs" href="faq.html">
+        <docbook href="#docbook"/>
+        <ignoring_javadocs href="#ignoring_javadocs"/>
+        <link_raw href="#link_raw"/>
+        <pdf_images href="#pdf_images"/>
+        <tab-index href="#tab-index"/>
+        <cli-xconf href="#cli-xconf"/>
+        <pageBreaks href="#pageBreaks"/>
+        <site-xml href="#site-xml"/>
+        <requirements href="#requirements"/>
+      </faq>
+      <changes label="Changes" href="changes.html"/>
+      <changes-rss href="changes.rss"/>
+      <todo label="Todo" href="todo.html"/>
+      <your-project label="Using Forrest" href="your-project.html">
+        <new_content_type href="#adding_new_content_type"/>
+        <new_dtd href="#new_dtd"/>
+        <webapp href="#webapp"/>
+        <skins href="#skins"/>
+        <new-skin href="#new_skin"/>
+        <invoking_from_ant href="#invoking_from_ant"/>
+      </your-project>
+      <validation label="XML Validation" href="validation.html"/>
+      <linking label="Menus and Linking" href="linking.html">
+        <menu_generation href="#menu_generation"/>
+        <tab-site href="#tab-site"/>
+      </linking>
+      <searching label="Searching" href="searching.html"/>
+      <skins label="Default Skins" href="skins.html"/>
+      <skin-package label="Skin Packages" href="skin-package.html"/>
+      <views label="Views-dev" href="views.html"/>
+      <forrest-contract label="Our Contract" href="forrest-contract.html"/>
+      <compliance label="Standards Compliance" href="compliance.html"/>
+      <howto label="How-To" href="howto/">
+        <overview label="Overview" href="index.html"/>
+        <write-howto label="Write a How-to" href="howto-howto.html"/>
+        <asf-mirror label="Download mirror" href="howto-asf-mirror.html"/>
+        <pdf-tab label="Create tab PDF" href="howto-pdf-tab.html"/>
+        <editcss label="Edit CSS (WYSIWYG)" href="howto-editcss.html"/>
+        <corner-css label="CSS corner SVG" href="howto-corner-images.html"/>
+        <maven label="Maven Integration" href="howto-forrest-from-maven.html"/>
+        <buildPlugin label="Build a Plugin" href="howto-buildPlugin.html"/>
+        <custom-html-source label="Custom html source" href="howto-custom-html-source.html"/>
+        <multi label="Multipage HowTo" href="multi/">
+          <intro label="Introduction" href="howto-multi.html"/>
+          <step1 label="Step 1" href="step1.html"/>
+          <step2 label="Step 2" href="step2.html"/>
+          <step3 label="Step 3" href="step3.html"/>
+        </multi>
+        <view label="Views">
+          <install label="Install views" href="howto-view-install.html"/>
+          <DSL label="forrest:view DSL" href="howto-view-dsl.html"/>
+          <contracts label="contract implementations" href="howto-view-contracts.html"/>
+        </view>
+      </howto>
+      <developers label="Advanced Topics">
+        <build label="Building Forrest" href="build.html">
+          <run href="#run"/>
+        </build>
+        <catalog label="Using DTD Catalogs" href="catalog.html"/>
+        <sitemap-ref label="Sitemap Reference" href="sitemap-ref.html">
+          <linkrewriting_impl href="#linkrewriting_impl"/>
+          <menu_generation_impl href="#menu_generation_impl"/>
+          <source_pipelines href="#source_pipelines"/>
+          <forrest_xmap href="#forrest_xmap"/>
+        </sitemap-ref>
+        <project-sitemap label="Project sitemap" href="project-sitemap.html"/>
+        <cap label="Sourcetype Action" href="cap.html"/>
+      </developers>
+      <upgrading_07 label="Upgrading to 0.7" href="upgrading_07.html">
+        <raw href="#raw"/>
+      </upgrading_07>
+      <samples label="Reference docs">
+        <dtd-docs-container label="DTD documentation">
+          <dtd-docs label="Overview" href="../dtdx/dtd-docs.html"/>
+          <document-v20-dtd label="document-v20" href="../dtdx/document-v20.dtdx.html"/>
+          <howto-v20-dtd label="howto-v20" href="../dtdx/howto-v20.dtdx.html"/>
+          <faq-v20-dtd label="faq-v20" href="../dtdx/faq-v20.dtdx.html"/>
+          <document-v13-dtd label="document-v13" href="../dtdx/document-v13.dtdx.html"/>
+          <howto-v13-dtd label="howto-v13" href="../dtdx/howto-v13.dtdx.html"/>
+          <faq-v13-dtd label="faq-v13" href="../dtdx/faq-v13.dtdx.html"/>
+        </dtd-docs-container>
+        <samples-container label="Doc samples">
+          <document-v12 href="../dtdx/document-v12.html"/>
+          <document-v13 label="document-v13" href="../dtdx/document-v13.html"/>
+          <document-v20 label="document-v20" href="../dtdx/document-v20.html"/>
+        </samples-container>
+      </samples>
+<!-- FIXME: Consider moving these documents into their own tab as there is no point in
+                    coying historic info from version to version.
+                    Options: Subtab "Old Stuff" in Docs tab or as a main tab 
+        -->
+      <older_documentation label="Older Docs">
+        <primer label="Forrest Primer" href="primer.html">
+          <cvs href="#cvs"/>
+        </primer>
+        <libre-intro label="Libre" href="libre-intro.html"/>
+        <dreams label="Dream list" href="dreams.html"/>
+        <cvsssh label="CVS over SSH" href="howto/cvs-ssh/howto-cvs-ssh.html"/>
+      </older_documentation>
+    </documentation>
+    <plugins label="0.70 Plugins" href="pluginDocs/plugins_0_70/" tab="p0_70">
+      <index label="Index" href="index.html"/>
+      <using label="Using Plugins" href="usingPlugins.html"/>
+      <infrastructure label="Plugin Infrastructure" href="pluginInfrastructure.html"/>
+    </plugins>
+  </v0.70>
+  <v0.60>
+    <documentation label="0.60" href="docs_0_60/" tab="v0_60">
+      <index label="Overview" href="index.html"/>
+      <faq label="FAQs" href="faq.html">
+        <docbook href="#docbook"/>
+        <ignoring_javadocs href="#ignoring_javadocs"/>
+        <link_raw href="#link_raw"/>
+        <pdf_images href="#pdf_images"/>
+      </faq>
+      <changes label="Changes" href="changes.html"/>
+      <todo label="Todo" href="todo.html"/>
+      <your-project label="Using Forrest" href="your-project.html">
+        <new_content_type href="#adding_new_content_type"/>
+        <new_dtd href="#new_dtd"/>
+        <webapp href="#webapp"/>
+        <skins href="#skins"/>
+        <new-skin href="#new_skin"/>
+        <invoking_from_ant href="#invoking_from_ant"/>
+      </your-project>
+      <upgrading_06 label="Upgrading to 0.6" href="upgrading_06.html"/>
+      <validation label="XML Validation" href="validation.html"/>
+      <linking label="Menus and Linking" href="linking.html">
+        <menu_generation href="#menu_generation"/>
+      </linking>
+      <searching label="Searching" href="searching.html"/>
+      <skins label="Default Skins" href="skins.html"/>
+      <skin-package label="Skin Packages" href="skin-package.html"/>
+      <forrest-contract label="Our Contract" href="forrest-contract.html"/>
+      <compliance label="Standards Compliance" href="compliance.html"/>
+      <howto label="How-To" href="howto/">
+        <overview label="Overview" href="index.html"/>
+        <single-page label="Single Page" href="howto-howto.html"/>
+        <multi-page label="Multi-Page" href="multi/">
+          <intro label="Intro" href="howto-multi.html"/>
+          <step1 label="Step 1" href="step1.html"/>
+          <step2 label="Step 2" href="step2.html"/>
+          <step3 label="Step 3" href="step3.html"/>
+        </multi-page>
+        <with-images label="With Images" href="bugzilla-patch/howto-bugzilla-patch.html"/>
+        <write-howto label="Write a How-to" href="howto-howto.html"/>
+        <asf-mirror label="Download mirror" href="howto-asf-mirror.html"/>
+        <pdf-tab label="Create tab PDF" href="howto-pdf-tab.html"/>
+      </howto>
+      <developers label="Advanced Topics">
+        <build label="Building Forrest" href="build.html"/>
+        <catalog label="Using DTD Catalogs" href="catalog.html"/>
+        <sitemap-ref label="Sitemap Reference" href="sitemap-ref.html">
+          <linkrewriting_impl href="#linkrewriting_impl"/>
+          <menu_generation_impl href="#menu_generation_impl"/>
+          <source_pipelines href="#source_pipelines"/>
+          <forrest_xmap href="#forrest_xmap"/>
+        </sitemap-ref>
+        <project-sitemap label="Project sitemap" href="project-sitemap.html"/>
+        <cap label="Sourcetype Action" href="cap.html"/>
+      </developers>
+      <samples label="Reference docs">
+        <dtd-docs-container label="DTD documentation">
+          <dtd-docs label="Overview" href="../dtdx/dtd-docs.html"/>
+          <document-v20-dtd label="document-v20" href="../dtdx/document-v20.dtdx.html"/>
+          <howto-v20-dtd label="howto-v20" href="../dtdx/howto-v20.dtdx.html"/>
+          <faq-v20-dtd label="faq-v20" href="../dtdx/faq-v20.dtdx.html"/>
+          <document-v13-dtd label="document-v13" href="../dtdx/document-v13.dtdx.html"/>
+          <howto-v13-dtd label="howto-v13" href="../dtdx/howto-v13.dtdx.html"/>
+          <faq-v13-dtd label="faq-v13" href="../dtdx/faq-v13.dtdx.html"/>
+        </dtd-docs-container>
+        <samples-container label="Doc samples">
+          <document-v12 href="../dtdx/document-v12.html"/>
+          <document-v13 label="document-v13" href="../dtdx/document-v13.html"/>
+          <document-v20 label="document-v20" href="../dtdx/document-v20.html"/>
+        </samples-container>
+      </samples>
+    </documentation>
+  </v0.60>
 </site>

Modified: forrest/trunk/site-author/content/xdocs/subversion_bestpractices.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/subversion_bestpractices.xml?view=diff&rev=527010&r1=527009&r2=527010
==============================================================================
--- forrest/trunk/site-author/content/xdocs/subversion_bestpractices.xml (original)
+++ forrest/trunk/site-author/content/xdocs/subversion_bestpractices.xml Mon Apr  9 20:48:52 2007
@@ -23,16 +23,18 @@
   </header>
   <body>
     <fixme author="">
-      This doc is under development. It should have general notes to assist
-      all developers to use the latest code in Forrest SVN and tips for working with SVN. An extra section would have other tips specific for Forrest committers.
-      Some tips should instead be added to the ASF-wide docs, where we can link to them.
+      This doc is under development. It should have general notes to assist all
+      developers to use the latest code in Forrest SVN and tips for working with
+      SVN. An extra section would have other tips specific for Forrest
+      committers. Some tips should instead be added to the ASF-wide docs, where
+      we can link to them.
     </fixme>
     <section id="goldenRules">
       <title>Golden Rules</title>
-        <p>
-            Using subversion seems so easy. But there are so many things you can do to mess up other peoples work. This
-            document tries to name just a few:   
-        </p>  
+      <p>
+        Using subversion seems so easy. But there are so many things you can do
+        to mess up other peoples work. This document tries to name just a few:
+      </p>
       <ul>
         <li>Be familiar with the <a href="site:version-control">instructions</a> for using Forrest SVN.
         </li>
@@ -40,15 +42,12 @@
         </li>
         <li><a href="contrib.html#svn-config">Configure</a> your svn client.
           <fixme author="">
-            Move the notes from contrib.html to here.
-            See other notes in
+            Move the notes from contrib.html to here. See other notes in
             <a href="http://marc.theaimsgroup.com/?t=114834506800002">email</a>.
-          </fixme>
-        </li>
-          <li>When moving an existing file  please use "svn move fromFile toFile". This ensures 
+          </fixme></li>
+        <li>When moving an existing file  please use "svn move fromFile toFile". This ensures 
              that the history of the item is not lost.</li>
       </ul>
-        
     </section>
   </body>
 </document>

Modified: forrest/trunk/site-author/content/xdocs/svn.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/svn.xml?view=diff&rev=527010&r1=527009&r2=527010
==============================================================================
--- forrest/trunk/site-author/content/xdocs/svn.xml (original)
+++ forrest/trunk/site-author/content/xdocs/svn.xml Mon Apr  9 20:48:52 2007
@@ -22,33 +22,33 @@
     <title>Version control</title>
   </header>
   <body>
-      <p>
-        The version control system Subversion is used by all ASF projects to manage their
-        source code and other resources.
-      </p>
-
-      <p>
-        The "trunk" is where the main development happens. From time-to-time "branches"
-         are used for specific short-term development tasks and later merged to trunk.
-      </p>
-
-      <p>
-        Developers can browse the trunk via 
-        <a href="http://svn.apache.org/repos/asf/forrest/">direct access</a> or
-        via the <a href="http://svn.apache.org/viewvc/forrest/trunk">ViewVC web interface</a>.
-        Similarly branches can be browsed (go up one level).
-      </p>
-      <p>
-        For every change, a notification email is automatically sent to the
-        <a href="site:mail-lists">svn@ mailing list</a>. Subscribe to that
-        list or search the archives to keep up-to-date with changes.
-      </p>
-      <p>
-        Developers can work with the most recent sources rather than a released version,
-        follow the <a href="site:build">instructions</a> to checkout your working copy.
-      </p>
-      <p>
-        See other <a href="site:svnBP">best practice notes</a>.
-      </p>
+    <p>
+      The version control system Subversion is used by all ASF projects to
+      manage their source code and other resources.
+    </p>
+    <p>
+      The "trunk" is where the main development happens. From time-to-time
+      "branches" are used for specific short-term development tasks and later
+      merged to trunk.
+    </p>
+    <p>
+      Developers can browse the trunk via
+      <a href="http://svn.apache.org/repos/asf/forrest/">direct access</a> or
+      via the <a href="http://svn.apache.org/viewvc/forrest/trunk">ViewVC web
+      interface</a>. Similarly branches can be browsed (go up one level).
+    </p>
+    <p>
+      For every change, a notification email is automatically sent to the
+      <a href="site:mail-lists">svn@ mailing list</a>. Subscribe to that list or
+      search the archives to keep up-to-date with changes.
+    </p>
+    <p>
+      Developers can work with the most recent sources rather than a released
+      version, follow the <a href="site:build">instructions</a> to checkout your
+      working copy.
+    </p>
+    <p>
+      See other <a href="site:svnBP">best practice notes</a>.
+    </p>
   </body>
 </document>

Modified: forrest/trunk/site-author/content/xdocs/tabs.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/tabs.xml?view=diff&rev=527010&r1=527009&r2=527010
==============================================================================
--- forrest/trunk/site-author/content/xdocs/tabs.xml (original)
+++ forrest/trunk/site-author/content/xdocs/tabs.xml Mon Apr  9 20:48:52 2007
@@ -16,13 +16,11 @@
   limitations under the License.
 -->
 <!DOCTYPE tabs PUBLIC "-//APACHE//DTD Cocoon Documentation Tab V1.1//EN" "http://forrest.apache.org/dtd/tab-cocoon-v11.dtd">
-
 <tabs software="Forrest"
     title="Apache Forrest"
     copyright="2005 The Apache Software Foundation"
     xmlns:xlink="http://www.w3.org/1999/xlink">
-
-  <!-- The rules for tabs are:
+<!-- The rules for tabs are:
     @dir will always have '/@indexfile' added.
     @indexfile gets appended to @dir if the tab is selected. Defaults to 'index.html'
     @href is not modified unless it is root-relative and obviously specifies a
@@ -32,17 +30,16 @@
    Tabs can be embedded to a depth of two. The second level of tabs will only 
     be displayed when their parent tab is selected.    
   -->
-
-    <tab id="home" label="Welcome" dir=""/>
-    <tab id="project" label="Developers" dir="" indexfile="contrib.html"/>
-    <tab id="docs" label="Versioned Docs" dir="versions">
-      <tab id="v0_70" label="0.70 (current)" dir="docs_0_70"/>
-      <tab id="v0_80" label="0.80-dev (under development)" dir="docs_0_80"/> 
-      <tab id="v0_60" label="0.60 (past)" dir="docs_0_60"/>
-    </tab>
-    <tab id="plugins" label="Plugins" dir="pluginDocs">
-      <tab id="p0_70" label="0.70 (current)" dir="pluginDocs/plugins_0_70"/>
-      <tab id="p0_80" label="0.80-dev (under development)" dir="pluginDocs/plugins_0_80"/> 
-    </tab>
-    <tab id="tools" label="Tools" dir="tools"/>
+  <tab id="home" label="Welcome" dir=""/>
+  <tab id="project" label="Developers" dir="" indexfile="contrib.html"/>
+  <tab id="docs" label="Versioned Docs" dir="versions">
+    <tab id="v0_70" label="0.70 (current)" dir="docs_0_70"/>
+    <tab id="v0_80" label="0.80-dev (under development)" dir="docs_0_80"/>
+    <tab id="v0_60" label="0.60 (past)" dir="docs_0_60"/>
+  </tab>
+  <tab id="plugins" label="Plugins" dir="pluginDocs">
+    <tab id="p0_70" label="0.70 (current)" dir="pluginDocs/plugins_0_70"/>
+    <tab id="p0_80" label="0.80-dev (under development)" dir="pluginDocs/plugins_0_80"/>
+  </tab>
+  <tab id="tools" label="Tools" dir="tools"/>
 </tabs>

Modified: forrest/trunk/site-author/content/xdocs/thanks.xml
URL: http://svn.apache.org/viewvc/forrest/trunk/site-author/content/xdocs/thanks.xml?view=diff&rev=527010&r1=527009&r2=527010
==============================================================================
--- forrest/trunk/site-author/content/xdocs/thanks.xml (original)
+++ forrest/trunk/site-author/content/xdocs/thanks.xml Mon Apr  9 20:48:52 2007
@@ -22,20 +22,20 @@
     <title>Thanks from Apache Forrest</title>
   </header>
   <body>
-      <p>
-        The Apache Forrest project gives thanks ...
-      </p>
+    <p>
+      The Apache Forrest project gives thanks ...
+    </p>
     <section id="general">
       <title>General thanks</title>
       <p>
-        <a href="http://www.apache.org/foundation/">The Apache Software Foundation (ASF)</a>
-        provides an excellent home for our community.
-        See also the
-        <a href="http://www.apache.org/foundation/thanks.html">ASF thanks</a>.
+        <a href="http://www.apache.org/foundation/">The Apache Software
+        Foundation (ASF)</a> provides an excellent home for our community. See
+        also the <a href="http://www.apache.org/foundation/thanks.html">ASF
+        thanks</a>.
       </p>
       <p>
-        The individual developers who participate via the
-        dev <a href="site:mail-lists">mailing list</a>.
+        The individual developers who participate via the dev
+        <a href="site:mail-lists">mailing list</a>.
       </p>
       <p>
         Our <a href="site:who">committers</a> and Project Management Committee.
@@ -45,27 +45,24 @@
         <a href="site:live-sites">example sites</a>.
       </p>
     </section>
-
     <section id="packaged-attribution">
       <title>Packaged software attribution</title>
       <p>
         Various products are packaged with the Apache Forrest distribution.
         These products use a license that is compatible with the Apache License.
-        Most products do not require specific attribution, but some do request that.
-        See the NOTICE.txt and LICENSE.txt files in the distribution.
+        Most products do not require specific attribution, but some do request
+        that. See the NOTICE.txt and LICENSE.txt files in the distribution.
       </p>
     </section>
-
     <section id="supporting-attribution">
       <title>Supporting software attribution</title>
       <p>
         Developers use various tools to assist with their work, such as
         <a href="site:catalog">xml editors</a> and IDEs such as
-        <a href="http://www.jetbrains.com/idea/opensource/">IntelliJ IDEA</a>
-        or
-        <a href="http://www.eclipse.org/">Eclipse</a>.
-        Most tools do not require attribution, but some do
-        (<a href="http://www.yourkit.com/">YourKit Java Profiler</a>).
+        <a href="http://www.jetbrains.com/idea/opensource/">IntelliJ IDEA</a> or
+        <a href="http://www.eclipse.org/">Eclipse</a>. Most tools do not require
+        attribution, but some do (<a href="http://www.yourkit.com/">YourKit Java
+        Profiler</a>).
       </p>
     </section>
   </body>



Mime
View raw message