Author: centic
Date: Thu Apr 18 13:34:13 2024
New Revision: 1917106
URL: http://svn.apache.org/viewvc?rev=1917106&view=rev
Log:
Add FAQ about requests to "fix this ASAP" and some other changes to
documentation
Modified:
poi/site/publish/changes.html
poi/site/publish/components/index.html
poi/site/publish/devel/guidelines.html
poi/site/publish/encryption.html
poi/site/publish/help/faq.html
poi/site/src/documentation/content/xdocs/devel/guidelines.xml
poi/site/src/documentation/content/xdocs/help/faq.xml
Modified: poi/site/publish/changes.html
URL:
http://svn.apache.org/viewvc/poi/site/publish/changes.html?rev=1917106&r1=1917105&r2=1917106&view=diff
==============================================================================
--- poi/site/publish/changes.html (original)
+++ poi/site/publish/changes.html Thu Apr 18 13:34:13 2024
@@ -227,13 +227,19 @@ document.write("Last Published: " + docu
<h3 class="boxed">Summary</h3>
<ul>
-<li>Upgrade log4j-api dependency to 2.22.1</li>
+<li>Upgrade log4j-api dependency to 2.23.1</li>
<li>Upgrade commons-codec dependency to 1.16.1</li>
-<li>Upgrade commons-io dependency to 2.15.1</li>
+<li>Upgrade commons-compress dependency to 1.26.1</li>
-<li>Upgrade pdfbox and graphics2d dependencies to 3.0.1</li>
+<li>Upgrade commons-io dependency to 2.16.1</li>
+
+<li>Upgrade pdfbox dependency to 3.0.2 and graphics2d dependency to 3.0.1</li>
+
+<li>Upgrade xmlsec dependency to 3.0.4</li>
+
+<li>Upgrade bouncycastle dependency to 1.78</li>
</ul>
<a name="Changes"></a>
@@ -255,6 +261,26 @@ document.write("Last Published: " + docu
<tr class="action">
<td><img class="icon" alt="fix" src="images/fix.png"></td><td><a
href="https://bz.apache.org/bugzilla/show_bug.cgi?id=68237";>68237</a></td><td>SXSSF</td><td>Some
boolean attribute values are written as true instead of 1</td>
</tr>
+
+<tr class="action">
+<td><img class="icon" alt="fix" src="images/fix.png"></td><td><a
href="https://bz.apache.org/bugzilla/show_bug.cgi?id=68703";>68703</a></td><td>XSLF</td><td>IllegalArgumentException:
Unexpected color choice CTFontCollectionImpl when reading font color for a
table cell</td>
+</tr>
+
+<tr class="action">
+<td><img class="icon" alt="fix" src="images/fix.png"></td><td><a
href="https://bz.apache.org/bugzilla/show_bug.cgi?id=68778";>68778</a></td><td>SXSSF</td><td>Fix
issue in SXSSF when there are missing fonts</td>
+</tr>
+
+<tr class="action">
+<td><img class="icon" alt="fix" src="images/fix.png"></td><td><a
href="https://github.com/apache/poi/pull/601";>github-601</a></td><td>XDGF</td><td>handle
elliptical arcs that have colinear points</td>
+</tr>
+
+<tr class="action">
+<td><img class="icon" alt="add" src="images/add.png"></td><td><a
href="https://github.com/apache/poi/pull/604";>github-604</a></td><td>XDGF</td><td>Support
for polylines</td>
+</tr>
+
+<tr class="action">
+<td><img class="icon" alt="add" src="images/add.png"></td><td><a
href="https://github.com/apache/poi/pull/607";>github-607</a></td><td>XWPF</td><td>Support
SVGs in XWPF</td>
+</tr>
</tbody>
</table>
Modified: poi/site/publish/components/index.html
URL:
http://svn.apache.org/viewvc/poi/site/publish/components/index.html?rev=1917106&r1=1917105&r2=1917106&view=diff
==============================================================================
--- poi/site/publish/components/index.html (original)
+++ poi/site/publish/components/index.html Thu Apr 18 13:34:13 2024
@@ -614,11 +614,11 @@ document.write("Last Published: " + docu
<tr>
<td colspan="1" rowspan="1">poi</td>
- <td colspan="1" rowspan="1"><a
href="https://search.maven.org/#artifactdetails|org.apache.logging.log4j|log4j-api|2.22.1|jar">log4j
2.x</a>,
+ <td colspan="1" rowspan="1"><a
href="https://search.maven.org/#artifactdetails|org.apache.logging.log4j|log4j-api|2.23.1|jar">log4j
2.x</a>,
<a
href="https://search.maven.org/#artifactdetails|commons-codec|commons-codec|1.16.1|jar">commons-codec</a>,
<a
href="https://search.maven.org/#artifactdetails|org.apache.commons|commons-collections4|4.4|jar">commons-collections</a>,
<a
href="https://search.maven.org/#artifactdetails|org.apache.commons|commons-math3|3.6.1|jar">commons-math3</a>
- <a
href="https://search.maven.org/#artifactdetails|commons-io|commons-io|2.15.1|jar">commons-io</a>
+ <a
href="https://search.maven.org/#artifactdetails|commons-io|commons-io|2.16.1|jar">commons-io</a>
</td>
<td colspan="1" rowspan="1">poi-version-yyyymmdd.jar</td>
@@ -679,10 +679,10 @@ document.write("Last Published: " + docu
<td colspan="1" rowspan="1"><a
href="https://search.maven.org/#artifactdetails|org.apache.xmlbeans|xmlbeans|5.2.0|jar">xmlbeans</a>
<br>
For signing:
- <a
href="https://search.maven.org/#artifactdetails|org.bouncycastle|bcpkix-jdk18on|1.77|jar">bcpkix-jdk18on</a>,
- <a
href="https://search.maven.org/#artifactdetails|org.bouncycastle|bcutil-jdk18on|1.77|jar">bcprov-jdk18on</a>,
- <a
href="https://search.maven.org/#artifactdetails|org.apache.santuario|xmlsec|3.0.3|bundle">xmlsec</a>,
- <a
href="https://search.maven.org/#artifactdetails|org.slf4j|slf4j-api|2.0.12|jar">slf4j-api</a>
+ <a
href="https://search.maven.org/#artifactdetails|org.bouncycastle|bcpkix-jdk18on|1.78|jar">bcpkix-jdk18on</a>,
+ <a
href="https://search.maven.org/#artifactdetails|org.bouncycastle|bcutil-jdk18on|1.78|jar">bcprov-jdk18on</a>,
+ <a
href="https://search.maven.org/#artifactdetails|org.apache.santuario|xmlsec|3.0.4|bundle">xmlsec</a>,
+ <a
href="https://search.maven.org/#artifactdetails|org.slf4j|slf4j-api|2.0.13|jar">slf4j-api</a>
</td>
<td colspan="1" rowspan="1">poi-ooxml-full-version-yyyymmdd.jar</td>
Modified: poi/site/publish/devel/guidelines.html
URL:
http://svn.apache.org/viewvc/poi/site/publish/devel/guidelines.html?rev=1917106&r1=1917105&r2=1917106&view=diff
==============================================================================
--- poi/site/publish/devel/guidelines.html (original)
+++ poi/site/publish/devel/guidelines.html Thu Apr 18 13:34:13 2024
@@ -317,7 +317,7 @@ document.write("Last Published: " + docu
<li>Add in new features, see <a
href="https://issues.apache.org/bugzilla/buglist.cgi?product=POI";>Bug
database</a> for suggestions.</li>
</ul>
-<p>The Apache <a
href="http://www.apache.org/dev/contributors.html";>Contributors Tech Guide</a>
gives a good overview how to start contributing patches.</p>
+<p>The Apache <a
href="https://infra.apache.org/contributors.html";>Contributors Tech Guide</a>
gives a good overview how to start contributing patches.</p>
<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
Modified: poi/site/publish/encryption.html
URL:
http://svn.apache.org/viewvc/poi/site/publish/encryption.html?rev=1917106&r1=1917105&r2=1917106&view=diff
==============================================================================
--- poi/site/publish/encryption.html (original)
+++ poi/site/publish/encryption.html Thu Apr 18 13:34:13 2024
@@ -568,9 +568,9 @@ document.write("Last Published: " + docu
<a href="components/">default dependencies</a>:</p>
<ul>
-<li>BouncyCastle bcpkix, bcprov and bcutil (tested against 1.77)</li>
+<li>BouncyCastle bcpkix, bcprov and bcutil (tested against 1.78)</li>
-<li>Apache Santuario "xmlsec" (tested against 3.0.3)</li>
+<li>Apache Santuario "xmlsec" (tested against 3.0.4)</li>
<li>and slf4j-api (tested against 2.0.x)</li>
Modified: poi/site/publish/help/faq.html
URL:
http://svn.apache.org/viewvc/poi/site/publish/help/faq.html?rev=1917106&r1=1917105&r2=1917106&view=diff
==============================================================================
--- poi/site/publish/help/faq.html (original)
+++ poi/site/publish/help/faq.html Thu Apr 18 13:34:13 2024
@@ -808,6 +808,38 @@ and
org.apache.xmlbeans.ThreadLocalUtil.clearAllThreadLocals();
</pre>
</div>
+<a name="faq-demand-fix-asap"></a>
+<h2 class="boxed">27.
+ How can I demand fixes or features in Apache PI to be done with
urgency?
+ </h2>
+<div class="section">
+<p>Apache POI is an open source project developed by a very small group of
volunteers.
+ </p>
+<p>Currently no-one is paid to work on new features or bug-fixes.
+ </p>
+<p>So it is considered fairly rude to "demand" things, especially "ASAP" is
quite frowned
+ upon and may even reduce the likelihood that your issue is
picked up and worked on.
+ </p>
+<p>If you would like to increase chances that your problem is tackled, you can
do a number of things
+ as follows, sorted by the amount of effort which may be
required from you:
+ </p>
+<ul>
+
+<li>Ensure your bug-report is complete and contains instructions/samples which
allow to reproduce the problem.
+ Ideally a self-sufficient test-case which does not need lots
of manual setup.</li>
+
+<li>Provide a summary of research of the root-cause of your problem.</li>
+
+<li>Provide a patch which fixes the problem. We usually like to have
unit-tests accompanying changes to
+ have high code-coverage and good confidence that issues
are fixed and few regressions are introduced
+ over time.</li>
+
+<li>Become a contributor! The entry threshold is actually not too high as soon
as you provided your
+ first successful bugfix. If you think you can spare the
time to contribute for some longer time,
+ becoming an official committer should not be too hard.</li>
+
+</ul>
+</div>
</div>
<!--+
|end content
Modified: poi/site/src/documentation/content/xdocs/devel/guidelines.xml
URL:
http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/devel/guidelines.xml?rev=1917106&r1=1917105&r2=1917106&view=diff
==============================================================================
--- poi/site/src/documentation/content/xdocs/devel/guidelines.xml (original)
+++ poi/site/src/documentation/content/xdocs/devel/guidelines.xml Thu Apr 18
13:34:13 2024
@@ -104,7 +104,7 @@
<li>Add in new features, see <a
href="https://issues.apache.org/bugzilla/buglist.cgi?product=POI";>Bug
database</a> for suggestions.</li>
</ul>
- <p>The Apache <a
href="http://www.apache.org/dev/contributors.html";>Contributors Tech Guide</a>
gives a good overview how to start contributing patches.</p>
+ <p>The Apache <a
href="https://infra.apache.org/contributors.html";>Contributors Tech Guide</a>
gives a good overview how to start contributing patches.</p>
<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,
Modified: poi/site/src/documentation/content/xdocs/help/faq.xml
URL:
http://svn.apache.org/viewvc/poi/site/src/documentation/content/xdocs/help/faq.xml?rev=1917106&r1=1917105&r2=1917106&view=diff
==============================================================================
--- poi/site/src/documentation/content/xdocs/help/faq.xml (original)
+++ poi/site/src/documentation/content/xdocs/help/faq.xml Thu Apr 18 13:34:13
2024
@@ -687,4 +687,32 @@ and
</source>
</answer>
</faq>
+ <faq id="faq-demand-fix-asap">
+ <question>
+ How can I demand fixes or features in Apache PI to be done with
urgency?
+ </question>
+ <answer>
+ <p>Apache POI is an open source project developed by a very small
group of volunteers.
+ </p>
+ <p>Currently no-one is paid to work on new features or bug-fixes.
+ </p>
+ <p>So it is considered fairly rude to "demand" things, especially
"ASAP" is quite frowned
+ upon and may even reduce the likelihood that your issue is
picked up and worked on.
+ </p>
+ <p>If you would like to increase chances that your problem is
tackled, you can do a number of things
+ as follows, sorted by the amount of effort which may be
required from you:
+ </p>
+ <ul>
+ <li>Ensure your bug-report is complete and contains
instructions/samples which allow to reproduce the problem.
+ Ideally a self-sufficient test-case which does not need lots
of manual setup.</li>
+ <li>Provide a summary of research of the root-cause of your
problem.</li>
+ <li>Provide a patch which fixes the problem. We usually like
to have unit-tests accompanying changes to
+ have high code-coverage and good confidence that issues
are fixed and few regressions are introduced
+ over time.</li>
+ <li>Become a contributor! The entry threshold is actually not
too high as soon as you provided your
+ first successful bugfix. If you think you can spare the
time to contribute for some longer time,
+ becoming an official committer should not be too hard.</li>
+ </ul>
+ </answer>
+ </faq>
</faqs>
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
