[LUCENE-2073] Document issues involved in building your index with one jdk version and then searching/updating with another

• Type: Task
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 4.9, 6.0
• Component/s: core/index
• Lucene Fields: New
• Assignee: Robert Muir
• Reporter: Mark Miller
• Created: 16/Nov/09 21:10
• Updated: 28/Aug/22 12:14
• Resolved: 03/Jan/19 01:02

Description

I think this needs to go in something of a permenant spot - this isn't a one time release type issues - its going to present over multiple release.

If there is nothing we can do here, then we just have to do the best we can -
such as a prominent notice alerting that if you transition JVM's between building and searching the index and you are using or doing X, things will break.

We should put this in a spot that is always pretty visible - perhaps even a new readme file titlted something like IndexBackwardCompatibility or something, to which we can add other tips and gotchyas as they come up. Or MaintainingIndicesAcrossVersions, or FancyWhateverGetsYourAttentionAboutUpgradingStuff. Or a permanent entry/sticky entry at the top of Changes.