poi-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From n...@apache.org
Subject svn commit: r1733118 - in /poi/site: publish/guidelines.html publish/index.html src/documentation/content/xdocs/index.xml src/documentation/skins/poi-site/xslt/html/document2html.xsl
Date Tue, 01 Mar 2016 18:03:37 GMT
Author: nick
Date: Tue Mar  1 18:03:36 2016
New Revision: 1733118

URL: http://svn.apache.org/viewvc?rev=1733118&view=rev
Log:
Add help wanted to the homepage, add text in case of being offline, and republish site

Modified:
    poi/site/publish/guidelines.html
    poi/site/publish/index.html
    poi/site/src/documentation/content/xdocs/index.xml
    poi/site/src/documentation/skins/poi-site/xslt/html/document2html.xsl

Modified: poi/site/publish/guidelines.html
URL: http://svn.apache.org/viewvc/poi/site/publish/guidelines.html?rev=1733118&r1=1733117&r2=1733118&view=diff
==============================================================================
--- poi/site/publish/guidelines.html (original)
+++ poi/site/publish/guidelines.html Tue Mar  1 18:03:36 2016
@@ -269,6 +269,10 @@ if (VERSION > 3) {
 </li>
      
 <li>
+<a href="#WhereHelpNeeded">Where is help needed on the project?</a>
+</li>
+     
+<li>
 <a href="#GetInvolved">I just want to get involved, but don't know where to start?</a>
 </li>
      
@@ -283,13 +287,17 @@ if (VERSION > 3) {
 <li>
 <a href="#Mentoring">Mentoring and Committership</a>
 </li>
+     
+<li>
+<a href="#FileFormatInformation">File Format Information</a>
+</li>
    
 </ul>
  
 
  
 <a name="Introduction"></a>
- <a name="Introduction-N1003D"></a>
+ <a name="Introduction-N10047"></a>
 <div class="h3">
 <h3>Introduction</h3>
 </div>
@@ -316,103 +324,35 @@ if (VERSION > 3) {
 <p>
      The POI project is <a href="http://www.opensource.org">OpenSource</a>
      and developed/distributed under the <a href="http://www.apache.org/foundation/license-faq.html">
-     Apache Software License</a>.  Unlike other licenses this license allows
-     free open source development; however, it does not require you to release
-     your source or use any particular license for your source.  If you wish
-     to contribute to POI (which you're very welcome and encouraged to do so)
-     then you must agree to release the rights of your source to us under this
-     license.
+     Apache Software License v2</a>.  Unlike some other licenses, the Apache 
+     license allows free open source development. Unlike some other Open Source
+     licenses, it does not require you to release your source or use any 
+     particular license for your code which builds on top of it. (There are a 
+     handful of restrictions, especially around attribution, notices and trademarks,
+     so it's worth a read of the license - it isn't scary!).  If you wish to 
+     contribute to Apache POI (which you're very welcome and encouraged to do so),
+     then you must agree to grant your contributions to us under the same license.
    </p>
   
-  
-<a name="Publicly+Available+Information+on+the+file+formats"></a>
-<div class="h4">
-<h4>Publicly Available Information on the file formats</h4>
-</div>
-  
-<p>
-   In early 2008, Microsoft made a fairly complete set of documentation
-   on the binary file formats freely and publicly available. These were 
-   released under the <a href="https://msdn.microsoft.com/en-us/openspecifications/default">
-   Open Specification Promise</a>, which does allow us to use them for
-   building open source software under the <a href="http://www.apache.org/foundation/license-FAQ.html">
-   Apache Software License</a>.
-  </p>
-  
-<p>
-   You can download the documentation on Excel, Word, PowerPoint and
-   Escher (drawing) from 
-   <a href="http://msdn.microsoft.com/en-us/library/cc313118.aspx">http://msdn.microsoft.com/en-us/library/cc313118.aspx</a>.
-   Documentation on a few of the supporting technologies used in these
-   file formats can be downloaded from
-   <a href="http://msdn.microsoft.com/en-us/library/jj633110.aspx">http://msdn.microsoft.com/en-us/library/jj633110.aspx</a>.
-  </p>
-  
-<p>
-   Previously, Microsoft published a book on the Excel 97 file format.
-   It can still be of plenty of use, and is handy dead tree form. Pick up
-   a copy of "Excel 97 Developer's Kit" from your favourite second hand
-   book store.
-  </p>
-  
-<p>
-   The newer Office Open XML (ooxml) file formats are documented as part
-   of the ECMA / ISO standardisation effort for the formats. This 
-   documentation is quite large, but you can normally find the bit you
-   need without too much effort! This can be downloaded from
-   <a href="http://www.ecma-international.org/publications/standards/Ecma-376.htm">http://www.ecma-international.org/publications/standards/Ecma-376.htm</a>,
-   and is also under the 
-   <a href="https://msdn.microsoft.com/en-us/openspecifications/default">OSP</a>.
-  </p>
-  
-<p>
-   Additionally for the newer Office Open XML (ooxml) file formats, you can
-   find some good introductary documentation (often clearer for getting
-   started with) at <a href="http://officeopenxml.com/">officeopenxml.com</a>,
-   which is an independent site documenting the file formats.
-  </p>
-  
-<p>
-   It is also worth checking the documentation and code of the other
-   open source implementations of the file formats.
-  </p>
-  
-  
-<a name="I+just+signed+an+NDA+to+get+a+spec+from+Microsoft+and+I%27d+like+to+contribute"></a>
-<div class="h4">
-<h4>I just signed an NDA to get a spec from Microsoft and I'd like to contribute</h4>
+ 
+
+ 
+<a name="WhereHelpNeeded"></a>
+ <a name="Where+is+help+needed+on+the+project%3F"></a>
+<div class="h3">
+<h3>Where is help needed on the project?</h3>
 </div>
    
-<p>
-     In short, stay away, stay far far away.  Implementing these file formats
-     in POI is done strictly by using public information. Most of this Public
-     Information currently comes from the documentation that Microsoft
-     makes freely available (see above). The rest of the public information
-     includes sources from other open source projects, books that state the 
-     purpose intended is for allowing implementation of the file format and 
-     do not require any non-disclosure agreement and just hard work. 
-     We are intent on keeping it legal, by contributing patches you agree to 
-     do the same.
-   </p>
-   
-<p> 
-     If you've ever received information regarding the OLE 2 Compound Document
-     Format under any type of exclusionary agreement from Microsoft, or  
-     received such information from a person bound by such an agreement, you 
-     cannot participate in this project. Sorry. Well, unless you can persuade 
-     Microsoft to release you from the terms of the NDA on the grounds that
-     most of the information is now publically available. However, if you have
-     been party to a Microsoft NDA, you will need to get clearance from Microsoft
-     before contributing.
-   </p>
+<div description="the Apache POI Project" project="poi" type="helpwanted" style="width:
80%;">
+<em>To view the <a href="https://helpwanted.apache.org/">"Help 
+          Wanted"</a> tasks, an internet connection is required.</em>
+</div>
+<script type="text/javascript" src="https://helpwanted.apache.org/widget.js"></script>
    
-<p>
-     Those submitting patches that show insight into the file format may be 
-     asked to state explicitly that they have only ever read the publicly
-     available file format information, and not any received under an NDA
-     or similar, and have only made us of the public documentation.
-   </p>
-  
+<p>Please note - only some of the areas where help is needed have been listed
+    in the <a href="https://helpwanted.apache.org/">Apache "Help Wanted!" tool</a>,

+    many others remain only in Bugzilla or listed as TODOs in the code. Please see 
+    the section below for more on these.</p>
  
 
  
@@ -422,11 +362,11 @@ if (VERSION > 3) {
 <h3>I just want to get involved, but don't know where to start?</h3>
 </div>
    
-<div description="the Apache POI Project" project="poi" type="helpwanted" style="width:
80%;"></div>
-<script type="text/javascript" src="https://helpwanted.apache.org/widget.js"></script>
-   
 <ul>
      
+<li>View the <a href="#WhereHelpNeeded">Apache "Help Wanted" tasks</a>
listed
+         above, in case any of those are ones you can help with.</li>
+     
 <li>Read the rest of the website, understand what POI is and what it does,
          the project vision, etc.</li>
      
@@ -729,6 +669,103 @@ if (VERSION > 3) {
     Project</a> website.</p>
   
 
+ 
+<a name="FileFormatInformation"></a>
+ <a name="File+Format+Information"></a>
+<div class="h3">
+<h3>File Format Information</h3>
+</div>
+  
+<a name="Publicly+Available+Information+on+the+file+formats"></a>
+<div class="h4">
+<h4>Publicly Available Information on the file formats</h4>
+</div>
+  
+<p>
+   In early 2008, Microsoft made a fairly complete set of documentation
+   on the binary file formats freely and publicly available. These were 
+   released under the <a href="https://msdn.microsoft.com/en-us/openspecifications/default">
+   Open Specification Promise</a>, which does allow us to use them for
+   building open source software under the <a href="http://www.apache.org/foundation/license-FAQ.html">
+   Apache Software License</a>.
+  </p>
+  
+<p>
+   You can download the documentation on Excel, Word, PowerPoint and
+   Escher (drawing) from 
+   <a href="http://msdn.microsoft.com/en-us/library/cc313118.aspx">http://msdn.microsoft.com/en-us/library/cc313118.aspx</a>.
+   Documentation on a few of the supporting technologies used in these
+   file formats can be downloaded from
+   <a href="http://msdn.microsoft.com/en-us/library/jj633110.aspx">http://msdn.microsoft.com/en-us/library/jj633110.aspx</a>.
+  </p>
+  
+<p>
+   Previously, Microsoft published a book on the Excel 97 file format.
+   It can still be of plenty of use, and is handy dead tree form. Pick up
+   a copy of "Excel 97 Developer's Kit" from your favourite second hand
+   book store.
+  </p>
+  
+<p>
+   The newer Office Open XML (ooxml) file formats are documented as part
+   of the ECMA / ISO standardisation effort for the formats. This 
+   documentation is quite large, but you can normally find the bit you
+   need without too much effort! This can be downloaded from
+   <a href="http://www.ecma-international.org/publications/standards/Ecma-376.htm">http://www.ecma-international.org/publications/standards/Ecma-376.htm</a>,
+   and is also under the 
+   <a href="https://msdn.microsoft.com/en-us/openspecifications/default">OSP</a>.
+  </p>
+  
+<p>
+   Additionally for the newer Office Open XML (ooxml) file formats, you can
+   find some good introductary documentation (often clearer for getting
+   started with) at <a href="http://officeopenxml.com/">officeopenxml.com</a>,
+   which is an independent site documenting the file formats.
+  </p>
+  
+<p>
+   It is also worth checking the documentation and code of the other
+   open source implementations of the file formats.
+  </p>
+  
+  
+<a name="I+just+signed+an+NDA+to+get+a+spec+from+Microsoft+and+I%27d+like+to+contribute"></a>
+<div class="h4">
+<h4>I just signed an NDA to get a spec from Microsoft and I'd like to contribute</h4>
+</div>
+   
+<p>
+     In short, stay away, stay far far away.  Implementing these file formats
+     in POI is done strictly by using public information. Most of this Public
+     Information currently comes from the documentation that Microsoft
+     makes freely available (see above). The rest of the public information
+     includes sources from other open source projects, books that state the 
+     purpose intended is for allowing implementation of the file format and 
+     do not require any non-disclosure agreement and just hard work. 
+     We are intent on keeping it legal, by contributing patches you agree to 
+     do the same.
+   </p>
+   
+<p> 
+     If you've ever received information regarding the OLE 2 Compound Document
+     Format under any type of exclusionary agreement from Microsoft, or  
+     received such information from a person bound by such an agreement, you 
+     cannot participate in this project. Sorry. Well, unless you can persuade 
+     Microsoft to release you from the terms of the NDA on the grounds that
+     most of the information is now publically available. However, if you have
+     been party to a Microsoft NDA, you will need to get clearance from Microsoft
+     before contributing.
+   </p>
+   
+<p>
+     Those submitting patches that show insight into the file format may be 
+     asked to state explicitly that they have only ever read the publicly
+     available file format information, and not any received under an NDA
+     or similar, and have only made us of the public documentation.
+   </p>
+  
+ 
+
 
 
 

Modified: poi/site/publish/index.html
URL: http://svn.apache.org/viewvc/poi/site/publish/index.html?rev=1733118&r1=1733117&r2=1733118&view=diff
==============================================================================
--- poi/site/publish/index.html (original)
+++ poi/site/publish/index.html Tue Mar  1 18:03:36 2016
@@ -384,20 +384,29 @@ if (VERSION > 3) {
 <div class="h3">
 <h3>Contributing </h3>
 </div>
-        
+      
 <p>
-		So you'd like to contribute to the project? Great! We need enthusiastic, hard-working,
talented folks to help
-		us on the project. So if you're motivated, ready, and have the time time download the source
from the
-		<a href="subversion.html">Subversion Repository</a>, <a href="howtobuild.html">build
the code</a>,
-		join the <a href="mailinglists.html">mailing lists</a> and we'll be happy to
help you get started on the project!
-        </p>
+        So you'd like to contribute to the project? Great! We need enthusiastic, 
+        hard-working, talented folks to help us on the project, no matter your
+        backgroun. So if you're motivated, ready, and have the time: Download the 
+        source from the
+        <a href="subversion.html">Subversion Repository</a>, 
+        <a href="howtobuild.html">build the code</a>, join the 
+        <a href="mailinglists.html">mailing lists</a>, and we'll be happy to

+        help you get started on the project!
+      </p>
+      
+<div description="the Apache POI Project" project="poi" type="helpwanted" style="width:
80%;">
+<em>To view the <a href="https://helpwanted.apache.org/">"Help 
+          Wanted"</a> tasks, an internet connection is required.</em>
+</div>
+<script type="text/javascript" src="https://helpwanted.apache.org/widget.js"></script>
       
 <p>
-	Please read our <a href="guidelines.html">Contribution Guidelines</a>. When
your contribution is ready
-	submit a patch to our <a href="https://bz.apache.org/bugzilla/buglist.cgi?product=POI">Bug
Database</a>.
+        Please read our <a href="guidelines.html">Contribution Guidelines</a>.

+        When your contribution is ready submit a patch to our 
+        <a href="https://bz.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</a>.
       </p>
-
-
     
   
   

Modified: poi/site/src/documentation/content/xdocs/index.xml
URL: http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/index.xml?rev=1733118&r1=1733117&r2=1733118&view=diff
==============================================================================
--- poi/site/src/documentation/content/xdocs/index.xml (original)
+++ poi/site/src/documentation/content/xdocs/index.xml Tue Mar  1 18:03:36 2016
@@ -147,18 +147,22 @@
     </section>
 
     <section><title>Contributing </title>
-        <p>
-		So you'd like to contribute to the project? Great! We need enthusiastic, hard-working,
talented folks to help
-		us on the project. So if you're motivated, ready, and have the time time download the source
from the
-		<link href="subversion.html">Subversion Repository</link>, <link href="howtobuild.html">build
the code</link>,
-		join the <link href="mailinglists.html">mailing lists</link> and we'll be happy
to help you get started on the project!
-        </p>
       <p>
-	Please read our <link href="guidelines.html">Contribution Guidelines</link>.
When your contribution is ready
-	submit a patch to our <link href="https://bz.apache.org/bugzilla/buglist.cgi?product=POI">Bug
Database</link>.
+        So you'd like to contribute to the project? Great! We need enthusiastic, 
+        hard-working, talented folks to help us on the project, no matter your
+        backgroun. So if you're motivated, ready, and have the time: Download the 
+        source from the
+        <link href="subversion.html">Subversion Repository</link>, 
+        <link href="howtobuild.html">build the code</link>, join the 
+        <link href="mailinglists.html">mailing lists</link>, and we'll be happy
to 
+        help you get started on the project!
+      </p>
+      <helpwanted/>
+      <p>
+        Please read our <link href="guidelines.html">Contribution Guidelines</link>.

+        When your contribution is ready submit a patch to our 
+        <link href="https://bz.apache.org/bugzilla/buglist.cgi?product=POI">Bug Database</link>.
       </p>
-
-
     </section>
   </body>
   <footer>

Modified: poi/site/src/documentation/skins/poi-site/xslt/html/document2html.xsl
URL: http://svn.apache.org/viewvc/poi/site/src/documentation/skins/poi-site/xslt/html/document2html.xsl?rev=1733118&r1=1733117&r2=1733118&view=diff
==============================================================================
--- poi/site/src/documentation/skins/poi-site/xslt/html/document2html.xsl (original)
+++ poi/site/src/documentation/skins/poi-site/xslt/html/document2html.xsl Tue Mar  1 18:03:36
2016
@@ -280,7 +280,10 @@ and tabs (tab2menu.xsl) to generate the
 
  <xsl:template match="helpwanted">
     <div style="width: 80%;" type="helpwanted" project="poi" 
-         description="the Apache POI Project"></div>
+         description="the Apache POI Project">
+      <em>To view the <a href="https://helpwanted.apache.org/">"Help 
+          Wanted"</a> tasks, an internet connection is required.</em>
+    </div>
     <script src="https://helpwanted.apache.org/widget.js" type="text/javascript"></script>
  </xsl:template>
 



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


Mime
View raw message