Thanks a lot Nick! That should avoid some confusion when we reference JavaDocs in support-mails and StackOverflow.
There are currently around 100 warnings, I'll try to bring that down somewhat in the coming days, it's mostly HTML violations and missing @param/@return/@throws. Dominik. On Tue, Oct 30, 2018 at 5:35 PM Nick Burch <[email protected]> wrote: > On Fri, 19 Oct 2018, Nick Burch wrote: > > The immediate change would be: > > * Everything at https://poi.apache.org/apidocs/ gets pushed to > > https://poi.apache.org/apidocs/dev/ > > * A new page at https://poi.apache.org/apidocs/ which says which > > versions you can see javadocs for online, and instructions on getting > > older ones from the released files > > * Redirects for as much as possible from https://poi.apache.org/apidocs/ > > to https://poi.apache.org/apidocs/dev/ to avoid breaking links > > * Tweaks to the site build ant file to support the changes > > These are now hopefully all done and sorted! > > > Then, and this is the bit which could use some more feedback: > > * /apidocs/4.0/ for the latest 4.0.x release (eg when we do 4.0.1 we > > replace them) > > * /apidocs/3.17/ for 3.17 final > > These two are done as well > > > I think the main thing that remains now, if anyone feels keen is that > building the latest Javadocs shows a bunch of broken references to other > classes / methods / fields. If someone has maybe an hour to spare, it'd be > great to run "ant javadocs", see the warnings for the broken references, > and fix as many of them as possible! > > Nick > > --------------------------------------------------------------------- > To unsubscribe, e-mail: [email protected] > For additional commands, e-mail: [email protected] > >
