Good idea!

One thing that'd make this a bit awkward is the way individual v1
RequestHandlers often map to many many v2 APIs.  (e.g.
CollectionsHandler covers > 40 "operation" types, for instance!).
Maybe using Javadoc's '@see' directive would scale a little better for
these cases?

In any case, +1 to the idea.  Did you have a JIRA?  (Or will you
create one following this thread?)

Best,

Jason

On Fri, Aug 9, 2024 at 5:07 PM David Smiley <dsmi...@apache.org> wrote:
>
> Recently, a colleague and I enhanced a V1 API and it wasn't obvious
> how to even find the V2 equivalent.  It was a face-palm moment for me
> after the work was done & merged:
>
> https://issues.apache.org/jira/browse/SOLR-17381?focusedCommentId=17872457&page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel#comment-17872457
>
> I'd like to propose that our V1 APIs link to the corresponding V2 APIs
> in Javadocs in a consistent fashion.  I'm thinking of something like:
>      Superceded by V2: {@link ClusterAPI} and {@link ListAliasesApi}
> and {@link CollectionStatusAPI}.
>
> Not sure if "original V2" vs "JAX-RS V2" should make a difference.
>
> ~ David Smiley
> Apache Lucene/Solr Search Developer
> http://www.linkedin.com/in/davidwsmiley
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscr...@solr.apache.org
> For additional commands, e-mail: dev-h...@solr.apache.org
>

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@solr.apache.org
For additional commands, e-mail: dev-h...@solr.apache.org

Reply via email to