Ah good spot Alex. I believe we can sort out these site issues after the release if needed (in case the site is rendered correctly after the release/deploy).
Bruno On Sat, 29 Oct 2022, 9:55 am Alex Herbert, <aherb...@apache.org> wrote: > I included the wrong link to the changes report. It is here: > > > https://home.apache.org/~aherbert/commons-numbers-1.1-RC1-site/changes-report.html > > Note that this custom site is only required as the commons-release-plugin > does not stage the multi-module site, so it is done manually for review. > > I note that there are two locations on the site using MathJax that are not > rendering correctly, particularly the user guide which uses it heavily for > some sections, e.g. > > > https://home.apache.org/~aherbert/commons-numbers-1.1-RC1-site/userguide/index.html#Continued_Fractions > > https://home.apache.org/~aherbert/commons-numbers-1.1-RC1-site/developers.html > (search for 'Pythagorean triplet') > > I do not know why this is happening. They render correctly locally using > the same site I used for the upload. The javadocs using MathJax are > rendered OK, e.g. > > > https://home.apache.org/~aherbert/commons-numbers-1.1-RC1-site/commons-numbers-docs/apidocs/org/apache/commons/numbers/gamma/IncompleteGamma.Lower.html > > The MathJax url for the javadoc and the site pages is different. Note that > the developers guide on the Numbers live site for the last release is also > broken for MathJax, so it may never have been working. The RNG site does > work for the same page and so this can be fixed post-deployment. For now > you can render the site locally to view the user guide: > > mvn site -DgenerateReports=false -N > open target/site/userguide/index.html > > Alex >