[
https://issues.apache.org/jira/browse/LUCENE-8733?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16798313#comment-16798313
]
Adrien Grand commented on LUCENE-8733:
--------------------------------------
I have mixed feelings. I have never found the "@since" tag very helpful, though
I can understand how some users could find it useful on important APIs, eg.
maybe things like BooleanQuery, FeatureField, LongPoint. However here we are
updating javadocs of package-private classes in the sandbox, so it's unclear to
me to whom it is going to be helpful? I'm not opposed to adding those, but a
bit surprised. I'd be curious to better understand your motivation?
> retrospectively add @since javadocs for 'intervals' classes
> -----------------------------------------------------------
>
> Key: LUCENE-8733
> URL: https://issues.apache.org/jira/browse/LUCENE-8733
> Project: Lucene - Core
> Issue Type: Wish
> Reporter: Christine Poerschke
> Assignee: Christine Poerschke
> Priority: Minor
> Attachments: LUCENE-8733-branch-7-4.patch
>
>
> LUCENE-8196 started 'intervals' and subsequent tickets extended it.
> This ticket proposes to retrospectively add {{@since X.Y}} javadocs for all
> the classes (and to then going forward perhaps continue to add them).
> And perhaps we could have an 'intervals' or similar JIRA components choice
> too?
--
This message was sent by Atlassian JIRA
(v7.6.3#76005)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
