[jira] [Commented] (LUCENE-9890) Clean up unnecessary @lucene.experimental annotations

["Tomoko Uchida (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/LUCENE-9890?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17310134#comment-17310134 ] 

Tomoko Uchida commented on LUCENE-9890:
---------------------------------------

There are lots of classes that are marked are "experimental" but it looks like the custom tag says nothing special (other than the author's feeling), and I guess users may be able to assess the matureness of APIs by the standard "@since" tag.

Are there people who miss the tag if I completely remove it from the main?

> Clean up unnecessary @lucene.experimental annotations
> -----------------------------------------------------
>
>                 Key: LUCENE-9890
>                 URL: https://issues.apache.org/jira/browse/LUCENE-9890
>             Project: Lucene - Core
>          Issue Type: Improvement
>            Reporter: Tomoko Uchida
>            Priority: Trivial
>
> 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.
> {code:java}
> lucene $ git grep lucene.experimental | wc -l
> 804
> {code}
> 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."
>   



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@lucene.apache.org
For additional commands, e-mail: issues-help@lucene.apache.org