eclipse-collections icon indicating copy to clipboard operation
eclipse-collections copied to clipboard

Stop updating Javadocs on Eclipse Collections website

Open prathasirisha opened this issue 3 years ago • 4 comments

Javadocs for Maven Central hosted artifacts are automatically updated here https://javadoc.io/doc/org.eclipse.collections/eclipse-collections-api/latest/index.html. Our Javadoc badges on README point to this link well.

We are also hosting Javadocs on our website https://www.eclipse.org/collections/javadoc/11.1.0/ and with each release, we have to generate javadocs (Jenkins build) and manually add (commit and push) nearly 7000 files to the EC website repo (hosted on https://git.eclipse.org/).

This seems redundant, proposing that we stop hosting javadocs on Eclipse Collections website starting next release.

prathasirisha avatar Jul 06 '22 16:07 prathasirisha

be aware that Don's blog posts link to that documentation, so they may need updates.

Bananeweizen avatar Jun 30 '23 10:06 Bananeweizen

+1 the process is painful. Thanks for surfacing this.

nikhilnanivadekar avatar Jun 30 '23 11:06 nikhilnanivadekar

Thanks for the reminder @Bananeweizen . I am willing to update my blog posts if the JavaDoc moves.

donraab avatar Jun 30 '23 14:06 donraab

We don’t need to remove the Javadoc files from the website. They’ll still exist and the blogs will work. We can simply remove the links on the website and replace them with the new ones.

nikhilnanivadekar avatar Jun 30 '23 14:06 nikhilnanivadekar