You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@poi.apache.org by ni...@apache.org on 2010/06/11 17:12:20 UTC

svn commit: r953716 - in /poi/trunk/src/documentation/content/xdocs: getinvolved/index.xml guidelines.xml

Author: nick
Date: Fri Jun 11 15:12:19 2010
New Revision: 953716

URL: http://svn.apache.org/viewvc?rev=953716&view=rev
Log:
A few little tweaks to the contribution guide

Modified:
    poi/trunk/src/documentation/content/xdocs/getinvolved/index.xml
    poi/trunk/src/documentation/content/xdocs/guidelines.xml

Modified: poi/trunk/src/documentation/content/xdocs/getinvolved/index.xml
URL: http://svn.apache.org/viewvc/poi/trunk/src/documentation/content/xdocs/getinvolved/index.xml?rev=953716&r1=953715&r2=953716&view=diff
==============================================================================
--- poi/trunk/src/documentation/content/xdocs/getinvolved/index.xml (original)
+++ poi/trunk/src/documentation/content/xdocs/getinvolved/index.xml Fri Jun 11 15:12:19 2010
@@ -119,17 +119,23 @@
      <li>Read the rest of the website, understand what POI is and what it does,
          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>Join the <link href="../mailinglists.html">mailing lists</link> and share your knowledge with others.</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>Contribute examples - if there's something people are often asking about on the <link href="../mailinglists.html">user list</link> which isn't covered in the documentation or current examples, try writing an example of this and uploading it as a patch.</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>Download the file format documentation from Microsoft -
       <link href="http://www.microsoft.com/interop/docs/OfficeBinaryFormats.mspx">OLE2 Binary File Formats</link> or
       <link href="http://www.ecma-international.org/publications/standards/Ecma-376.htm">OOXML XML File Formats</link></li>
      <li>Submit patches (see below) of your contributions, modifications.</li>
-     <li>Fill out new features, see <link href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI">Bug database</link> for suggestions.</li>
+     <li>Check the <link href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI">bug database</link> for simple problem reports, and write a patch to fix the problem</li>
+     <li>Add in new features, see <link href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI">Bug database</link> for suggestions.</li>
    </ul>
+   <p>The Nutch project also have a very useful guide on becoming a 
+    new developer in their project. While it is written for their project,
+    a large part of it will apply to POI too. You can read it at
+    <link href="http://wiki.apache.org/nutch/Becoming_A_Nutch_Developer">http://wiki.apache.org/nutch/Becoming_A_Nutch_Developer</link></p>
   </section>
   <section><title>Submitting Patches</title>
    <p>

Modified: poi/trunk/src/documentation/content/xdocs/guidelines.xml
URL: http://svn.apache.org/viewvc/poi/trunk/src/documentation/content/xdocs/guidelines.xml?rev=953716&r1=953715&r2=953716&view=diff
==============================================================================
--- poi/trunk/src/documentation/content/xdocs/guidelines.xml (original)
+++ poi/trunk/src/documentation/content/xdocs/guidelines.xml Fri Jun 11 15:12:19 2010
@@ -119,17 +119,23 @@
      <li>Read the rest of the website, understand what POI is and what it does,
          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>Join the <link href="mailinglists.html">mailing lists</link> and share your knowledge with others.</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>Contribute examples - if there's something people are often asking about on the <link href="mailinglists.html">user list</link> which isn't covered in the documentation or current examples, try writing an example of this and uploading it as a patch.</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>Download the file format documentation from Microsoft -
       <link href="http://www.microsoft.com/interop/docs/OfficeBinaryFormats.mspx">OLE2 Binary File Formats</link> or
       <link href="http://www.ecma-international.org/publications/standards/Ecma-376.htm">OOXML XML File Formats</link></li>
      <li>Submit patches (see below) of your contributions, modifications.</li>
-     <li>Fill out new features, see <link href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI">Bug database</link> for suggestions.</li>
+     <li>Check the <link href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI">bug database</link> for simple problem reports, and write a patch to fix the problem</li>
+     <li>Add in new features, see <link href="http://issues.apache.org/bugzilla/buglist.cgi?product=POI">Bug database</link> for suggestions.</li>
    </ul>
+   <p>The Nutch project also have a very useful guide on becoming a 
+    new developer in their project. While it is written for their project,
+    a large part of it will apply to POI too. You can read it at
+    <link href="http://wiki.apache.org/nutch/Becoming_A_Nutch_Developer">http://wiki.apache.org/nutch/Becoming_A_Nutch_Developer</link></p>
   </section>
   <section><title>Submitting Patches</title>
    <p>



---------------------------------------------------------------------
To unsubscribe, e-mail: commits-unsubscribe@poi.apache.org
For additional commands, e-mail: commits-help@poi.apache.org