[SOLR-17398] Add Javadoc links from V1 APIs to V2 APIs

• Type: Sub-task
• Status: Open
• Priority: Minor
• Resolution: Unresolved
• Component/s: v2 API
• Assignee: Unassigned
• Reporter: David Smiley
• Created: 10/Aug/24 06:09
• Updated: 10/Aug/24 06:09

Description

The Java code for V1 APIs should have a javadoc comment pointing to equivalent v2 APIs when it's not obvious (when V1 is not simply calling V2 and/or they occupy different classes).  If V2 doesn't exist yet, a TBD/TODO comment is helpful nonetheless.

For example in CollectionsHandler above the enum entry for CLUSTERSTATUS_OP, add:

Superceded by V2: {@link ClusterAPI} and {@link ListAliasesApi}
and {@link CollectionStatusAPI}.

In that specific case, the ClusterStatus class itself could be marked deprecated, albeit that deprecation should perhaps be only for Solr 10 as some of such classes will not be removed until Solr 11. Nonetheless a javadoc comment saying will be removed in Solr 11 would be very helpful!

Perhaps in many cases there is no need because V1 tends to call V2.