[LUCENE-9890] Retire @lucene.experimental tag and enforce @since tag for public classes

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Won't Fix
• Component/s: general/javadocs
• Lucene Fields: New
• Assignee: Unassigned
• Reporter: Tomoko Uchida
• Created: 28/Mar/21 07:01
• Updated: 28/Aug/22 16:19
• Resolved: 28/Mar/21 22:35

Description

We have 800+ @lucene.experimental annotations in the main branch. Many of those classes were created years ago and have been time-tested on various setups, so may be able to be cleaned up.

lucene $ git grep lucene.experimental | wc -l
804

BTW, do we really need this annotation...?
The description of it says nothing about when we should remove it from the javadocs: "lucene.experimental:a:WARNING: This API is experimental and might change in incompatible ways in the next release."
 

Sub-Tasks

• Ensure @since tag for public classes: Resolved