[SOLR-15801] Ref Guide docs on Java support out of date

• Type: Bug
• Status: Open
• Priority: Major
• Resolution: Unresolved
• Component/s: documentation
• Assignee: Unassigned
• Reporter: Cassandra Targett
• Created: 16/Nov/21 15:47
• Updated: 17/Nov/21 14:25

Description

Back in SOLR-12809 (Apr 2019), Erick worked to add some docs to the system_requirements.adoc Ref Guide page about supported Java versions. There was a lot of discussion how to do this, but we ultimately settled on (in part):

Lucene/Solr 8.x is the current stable release line and will have "point releases", i.e., 8.1, 8.2, etc. until Lucene/Solr 9.0 is released.

Solr 8.x is currently tested against Java 8, 9, 10, 11, 12 and (pre-release) 13.

There is also development and testing with the future Lucene/Solr 9.x release line, which will require Java 11 as a minimum version. This line is currently tested against Java 11, 12 and (pre-release) 13.

Lucene/Solr 7.x and earlier release lines are not tested on a continuous basis.

This hasn't been updated since 2019 so is now very much out of date - Java 13 isn't pre-release anymore, and I feel sure we're not still testing 9, 10, 12 or any other non-LTS that's already EOL. I only skimmed SOLR-12809 but I didn't really see how he found the list he decided to use - if I had to guess, though, I'd say he looked at all the various Jenkins jobs being run on Apache hardware, Uwe's hardware, and maybe Steve Rowe's.

I'm not really sure how to deal with this, since there's 2 parts to the current problem:

1. Update the page in the Ref Guide to say what is being tested today (and republish 8.10 and 8.11 maybe), which depends on figuring out what's tested today
2. Figure out how we're going to keep this up to date on an ongoing basis, since any release could be tested on different JDKs which would make the page out of date at any time.