Further updates to the site

git-svn-id: https://svn.apache.org/repos/asf/jakarta/poi/trunk@542593 13f79535-47bb-0310-9956-ffa450edef68

8 files changed, 197 insertions, 13 deletions

diff --git a/src/documentation/content/xdocs/book.xml b/src/documentation/content/xdocs/book.xml
index e9c00f16d2..4666d7765a 100644
--- a/src/documentation/content/xdocs/book.xml
+++ b/src/documentation/content/xdocs/book.xml
@@ -75,7 +75,7 @@
     </menu>
 
     <menu label="Code">
-        <menu-item label="Subversion (current source code)" href="http://jakarta.apache.org/site/cvsindex.html"/>
+        <menu-item label="Subversion (current source code)" href="subversion.html"/>
         <menu-item label="Top Voted Bugs" href="http://issues.apache.org/bugzilla/buglist.cgi?votes=1&amp;product=POI&amp;order=bugs.votes"/>
         <menu-item label="Bug Database" href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI"/>
         <menu-item label="Patches" href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI&amp;short_desc=%5BPATCH%5D&amp;short_desc_type=allwordssubstr"/>
diff --git a/src/documentation/content/xdocs/getinvolved/book.xml b/src/documentation/content/xdocs/getinvolved/book.xml
index 9e9f13771a..d139954975 100644
--- a/src/documentation/content/xdocs/getinvolved/book.xml
+++ b/src/documentation/content/xdocs/getinvolved/book.xml
@@ -24,14 +24,15 @@
       copyright="@year@ POI Project"
       xmlns:xlink="http://www.w3.org/1999/xlink">
 
-  <menu label="Jakarta POI">
+  <menu label="Apache POI">
     <menu-item label="Top" href="../index.html"/>
   </menu>
 
   <menu label="Get Involved">
     <menu-item label="Contributing" href="index.html"/>
     <menu-item label="Branching" href="branching.html"/>
-    <menu-item label="Mail Lists" href="http://jakarta.apache.org/site/mail2.html#poi"/>
+    <menu-item label="Subversion" href="../subversion.html"/>
+    <menu-item label="Mail Lists" href="../mailinglists.html"/>
   </menu>
 
 </book>
diff --git a/src/documentation/content/xdocs/getinvolved/branching.xml b/src/documentation/content/xdocs/getinvolved/branching.xml
index 4957505652..166575be4e 100644
--- a/src/documentation/content/xdocs/getinvolved/branching.xml
+++ b/src/documentation/content/xdocs/getinvolved/branching.xml
@@ -24,7 +24,7 @@
     <header>
         <title>Branching</title>
         <authors>
-            <person id="GJS" name="Glen Stampoultzis" email="poi-user@jakarta.apache.org"/>
+            <person id="GJS" name="Glen Stampoultzis" email="user@poi.apache.org"/>
         </authors>
     </header>
 
diff --git a/src/documentation/content/xdocs/getinvolved/index.xml b/src/documentation/content/xdocs/getinvolved/index.xml
index 9f55aa6db9..0ee102beef 100644
--- a/src/documentation/content/xdocs/getinvolved/index.xml
+++ b/src/documentation/content/xdocs/getinvolved/index.xml
@@ -82,27 +82,27 @@
          the project vision, etc.</li>
      <li>Use POI a bit, look for gaps in the documentation and examples.</li>
      <li>Join the mail lists and share your knowledge with others.</li>
-     <li>Get <link href="http://jakarta.apache.org/site/cvsindex.html">Subversion</link> and check out the POI source tree</li>
+     <li>Get <link href="../subversion.html">Subversion</link> and check out the POI source tree</li>
      <li>Documentation is always the best place to start contributing, maybe you found that if the documentation just told you how to do X then it would make more sense, modify the documentation.</li>
      <li>Get used to building POI, you'll be doing it a lot, be one with the build, know its targets, etc.</li>
      <li>Write Unit Tests.  Great way to understand POI.  Look for classes that aren't tested, or aren't tested on a public/protected method level, start there.</li>
      <li>(HSSF)Get the Excel 97 Developer's Kit - its out of print but its dirt cheap (seen copies for under $15 (US)) used on <link href="http://www.amazon.com">amazon</link>.  It explains the Excel file format.</li>
      <li>Submit patches (see below) of your contributions, modifications.</li>
-     <li>Fill out new features, see <link href="http://jakarta.apache.org/site/bugs.html">Bug database</link> for suggestions.</li>
+     <li>Fill out new features, see <link href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI">Bug database</link> for suggestions.</li>
    </ul>
   </section>
   <section><title>Submitting Patches</title>
    <p>
      Create patches by getting the latest sources from Subversion.
-     Alter or add files as appropriate.  Then, from the jakarta-poi directiory,
+     Alter or add files as appropriate.  Then, from the poi directiory,
      type svn diff > mypatch.patch.  This will capture all of your changes
      in a patch file of the appropriate format.  Next, if you've added any 
      files, create an archive (tar.bz2 preferred as its the smallest) in a 
-     path-preserving archive format, relative to your jakarta-poi directory. 
+     path-preserving archive format, relative to your poi directory. 
      You'll attach both files in the next step.
    </p>
    <p> 
-     Patches are submitted via the <link href="http://jakarta.apache.org/site/bugs.html">Bug Database</link>.  
+     Patches are submitted via the <link href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</link>.  
      Create a new bug, set the subject to [PATCH] followed by a brief description.  Explain you patch and any special instructions and submit/save it.  
      Next, go back to the bug, and create attachements for the patch files you
      created.  Be sure to describe not only the files purpose, but its format. 
diff --git a/src/documentation/content/xdocs/index.xml b/src/documentation/content/xdocs/index.xml
index e478df0bda..da2d5ed3a8 100644
--- a/src/documentation/content/xdocs/index.xml
+++ b/src/documentation/content/xdocs/index.xml
@@ -35,9 +35,9 @@
 	  <p>After quite a wait, version 3.0 of Apache POI (formerly
 		Apache Jakarta POI) has now been released. You can 
 		<link href="./changes.html">view the changelog</link>, and 
-		<link href="http://www.apache.org/dyn/closer.cgi/jakarta/poi/release/">download</link>
+		<link href="http://www.apache.org/dyn/closer.cgi/poi/release/">download</link>
 		the source and binaries from your
-		<link href="http://www.apache.org/dyn/closer.cgi/jakarta/poi/release/">local mirror</link>.</p>
+		<link href="http://www.apache.org/dyn/closer.cgi/poi/release/">local mirror</link>.</p>
 	</section>
 
     <section><title>Purpose</title>
diff --git a/src/documentation/content/xdocs/mailinglists.xml b/src/documentation/content/xdocs/mailinglists.xml
new file mode 100644
index 0000000000..6f2b68c98d
--- /dev/null
+++ b/src/documentation/content/xdocs/mailinglists.xml
@@ -0,0 +1,97 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   ====================================================================
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+   ====================================================================
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "./dtd/document-v11.dtd">
+
+<document>
+  <header>
+    <title>Mailing Lists</title>
+    <authors>
+      <person id="NB" name="Nick Burch" email="nick@apache.org"/>
+    </authors>
+  </header>
+  
+  <body>
+    <section><title>Mailing Lists - Guidelines</title>
+      <p>
+        <strong>Before subscribing to any of the mailing lists, please make
+        sure that you have read and understand the following 
+        guidelines:</strong>
+      </p>
+      <ul>
+        <li><link href="http://www.apache.org/foundation/mailinglists.html">ASF guide to Mailing Lists</link></li>
+        <li><link href="http://www.apache.org/dev/contrib-email-tips.html">ASF Tips for email contributors</link></li>
+        <li><link href="http://jakarta.apache.org/site/mail.html">The Jakarta guide to Mailing Lists</link></li>
+      </ul>
+    </section>
+    <section><title>Lists</title>
+      <section><title>The POI User List</title>
+        <p>
+          <strong>Medium Traffic</strong>
+          <link href="mailto:user-subscribe@poi.apache.org">Subscribe</link>
+          <link href="mailto:user-unsubscribe@poi.apache.org">Unsubscribe</link>
+          <link href="http://mail-archives.apache.org/mod_mbox/poi-user/">Archive</link>
+          <link href="http://news.gmane.org/thread.php?group=gmane.comp.jakarta.poi.user">gmane.org</link>
+        </p>
+        <p>
+          This list is for users of POI to ask questions, share knowledge, 
+          and discuss issues. POI developers are also expected to be 
+          lurking on this list to offer support to users of POI.
+        </p> 
+      </section>
+      <section><title>The POI Developer List</title>
+        <p>
+          <strong>Low Traffic</strong>
+          <link href="mailto:dev-subscribe@poi.apache.org">Subscribe</link>
+          <link href="mailto:dev-unsubscribe@poi.apache.org">Unsubscribe</link>
+          <link href="http://mail-archives.apache.org/mod_mbox/poi-dev/">Archive</link>
+          <link href="http://news.gmane.org/thread.php?group=gmane.comp.jakarta.poi.dev">gmane.org</link>
+        </p>
+        <p>
+          This is the list where participating developers of the POI 
+          project meet and discuss issues, code changes/additions, etc. 
+          Subscribers to this list also get notices of each and every 
+          code change, build results, testing notices, etc. 
+          <strong>Do not send mail to this list with usage questions or 
+          configuration problems.</strong>
+        </p> 
+      </section>
+      <section><title>The POI General List</title>
+        <p>
+          <strong>Low Traffic</strong>
+          <link href="mailto:general-subscribe@poi.apache.org">Subscribe</link>
+          <link href="mailto:general-unsubscribe@poi.apache.org">Unsubscribe</link>
+          <link href="http://mail-archives.apache.org/mod_mbox/poi-general/">Archive</link>
+        </p>
+        <p>
+          This list exists for general discussions on POI, not specific to
+          code or problems with code. Used for discussion of general matters
+          relating to all of the POI project, such as the website and
+          changes in procedures.
+        </p> 
+      </section>
+    </section>
+  </body>
+  <footer>
+    <legal>
+      Copyright 2007 The Apache Software Foundation or its licensors, as applicable.
+      $Revision: 496536 $ $Date: 2007-01-15 23:11:09 +0000 (Mon, 15 Jan 2007) $
+    </legal>
+  </footer>
+</document>
diff --git a/src/documentation/content/xdocs/mirrors.xml b/src/documentation/content/xdocs/mirrors.xml
index f21ef4ee00..e133fa4339 100644
--- a/src/documentation/content/xdocs/mirrors.xml
+++ b/src/documentation/content/xdocs/mirrors.xml
@@ -21,7 +21,7 @@
 
 <document>
   <header>
-    <title>Jakarta POI Mirror Site</title>
+    <title>Apache POI Mirror Site</title>
     <authors>
       <person id="AO" name="Andrew C. Oliver" email="acoliver@apache.org"/>
     </authors>
@@ -31,7 +31,7 @@
     <section><title>Mirrors</title>
         <p>
            These are mirrors of the 
-           <link href="http://jakarta.apache.org/poi">POI</link> website.
+           <link href="http://poi.apache.org/">POI</link> website.
            If you know of others...report them! :-)
         </p>                        
     </section>
diff --git a/src/documentation/content/xdocs/subversion.xml b/src/documentation/content/xdocs/subversion.xml
new file mode 100644
index 0000000000..2e8b1b1d82
--- /dev/null
+++ b/src/documentation/content/xdocs/subversion.xml
@@ -0,0 +1,86 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+   ====================================================================
+   Licensed to the Apache Software Foundation (ASF) under one or more
+   contributor license agreements.  See the NOTICE file distributed with
+   this work for additional information regarding copyright ownership.
+   The ASF licenses this file to You under the Apache License, Version 2.0
+   (the "License"); you may not use this file except in compliance with
+   the License.  You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+   ====================================================================
+-->
+<!DOCTYPE document PUBLIC "-//APACHE//DTD Documentation V1.1//EN" "./dtd/document-v11.dtd">
+
+<document>
+  <header>
+    <title>Subversion - Source Code Repository</title>
+    <authors>
+      <person id="NB" name="Nick Burch" email="nick@apache.org"/>
+    </authors>
+  </header>
+  
+  <body>
+    <section><title>Download the Source</title>
+      <p>
+         Most users of the source code probably don't need to have day to 
+         day access to the source code as it changes. For these users we 
+         provide easy to unpack source code downloads via our
+         <link href="ext:download">download pages.</link>
+      </p>
+    </section>
+    <section><title>Access the Version Controlled Source Code</title>
+      <p>
+         For information on connecting to the ASF Subversion repositories, 
+         see the 
+         <link href="http://www.apache.org/dev/version-control.html">version control page.</link>
+      </p>
+
+      <p>Subversion is an open-source version control system. The root url
+       of the ASF Subversion repository is 
+       <link href="http://svn.apache.org/repos/asf/">http://svn.apache.org/repos/asf/</link>
+       for non-committers and 
+       <link href="https://svn.apache.org/repos/asf/">https://svn.apache.org/repos/asf/</link> 
+       for committers. 
+      </p>
+
+      <p><strong>NOTE</strong>: When checking out a subproject using 
+       subversion, ensure that you are checking out a tag, a branch or trunk 
+       (the main-line) and not all tags and branches, to avoid filling up 
+       your hard-disk and wasting bandwidth.
+      </p>
+
+      <p><strong>NOTE</strong>: See this 
+       <link href="http://jakarta.apache.org/commons/svninfo.html">Subversion
+        information</link> page for a brief description of the relationship be
+       tween URL tuples such as <em>trunks-proper</em> and <em>proper</em>.</p>
+
+      <ul>
+       <li>For read only access to the Apache POI svn, please use
+        <link href="http://svn.apache.org/repos/asf/poi/trunk/">http://svn.apache.org/repos/asf/poi/trunk/</link></li>
+       <li>For committers (write) access to the Apache POI svn, please use
+        <link href="https://svn.apache.org/repos/asf/poi/trunk/">https://svn.apache.org/repos/asf/poi/trunk/</link></li>
+       <li>To browse the svn repository in your web browser, please us
+        <link href="http://svn.apache.org/viewcvs.cgi/poi/">ViewSVN</link></li>
+      </ul>
+
+      <p>If you are not a <em>Committer</em>, but you want to submit patches 
+       or even request commit privileges, please see our 
+       <link href="getinvolved/index.html">Guidelines</link> for more 
+       information.</p>
+    </section>
+  </body>
+  <footer>
+    <legal>
+      Copyright 2007 The Apache Software Foundation or its licensors, as applicable.
+      $Revision: 496536 $ $Date: 2007-01-15 23:11:09 +0000 (Mon, 15 Jan 2007) $
+    </legal>
+  </footer>
+</document>