]> source.dussan.org Git - poi.git/commitdiff
Further updates to the site
authorNick Burch <nick@apache.org>
Tue, 29 May 2007 17:18:45 +0000 (17:18 +0000)
committerNick Burch <nick@apache.org>
Tue, 29 May 2007 17:18:45 +0000 (17:18 +0000)
git-svn-id: https://svn.apache.org/repos/asf/jakarta/poi/trunk@542593 13f79535-47bb-0310-9956-ffa450edef68

src/documentation/content/xdocs/book.xml
src/documentation/content/xdocs/getinvolved/book.xml
src/documentation/content/xdocs/getinvolved/branching.xml
src/documentation/content/xdocs/getinvolved/index.xml
src/documentation/content/xdocs/index.xml
src/documentation/content/xdocs/mailinglists.xml [new file with mode: 0644]
src/documentation/content/xdocs/mirrors.xml
src/documentation/content/xdocs/subversion.xml [new file with mode: 0644]

index e9c00f16d2143cd5544e6f53969059ec4558ddf6..4666d7765a082cedb9dc013da25876e8e5a79659 100644 (file)
@@ -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"/>
index 9e9f13771a28ef779e82f774caa1fd91cf641de0..d139954975e9eb060dc5ac1480b0eccd7cbd1518 100644 (file)
       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>
index 495750565208d2ecde8773688c0d5ace7f140ecf..166575be4e0c03c5132b4e83cafe8581f8dfddca 100644 (file)
@@ -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>
 
index 9f55aa6db9dd9872f98dc09c6ef1768fb43ececd..0ee102beef1a4f4bbb57e543f880e07d26779c7a 100644 (file)
          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. 
index e478df0bda4e97c864eac5c3f24ad6575e7504c4..da2d5ed3a88b81c33a56ea097de53474c08db2f4 100644 (file)
@@ -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 (file)
index 0000000..6f2b68c
--- /dev/null
@@ -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>
index f21ef4ee00cee670784f463682aa50425f28f42a..e133fa4339b252a59f429cbd4bd58e54a154ccfc 100644 (file)
@@ -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 (file)
index 0000000..2e8b1b1
--- /dev/null
@@ -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>