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: [email protected]
For additional commands, e-mail: [email protected]
