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: commits-unsubscr...@poi.apache.org For additional commands, e-mail: commits-h...@poi.apache.org