SOLR-18160: Deprecate Overseer ADDROLE and REMOVEROLE Collection API operations

[abumarjikar]

https://issues.apache.org/jira/browse/SOLR-18160

Description

Deprecate the legacy ADDROLE and REMOVEROLE Overseer Collection API operations. Users should transition to managing node roles at startup via the -Dsolr.node.roles parameter.

Solution

• Added deprecation logging messages using DeprecationLog.log in OverseerRoleCmd.java for both ADDROLE and REMOVEROLE operations, alerting users that they will be removed in Solr 11.
• Added @Deprecated(since = "10.1") annotations and updated JavaDoc documentation for addRole and removeRole helper methods within CollectionAdminRequest.java.
• Marked ADDROLE and REMOVEROLE enum entries with @Deprecated(since = "10.1") in CollectionAction inside CollectionParams.java.

Checklist

Please review the following and check all that apply:

• I have reviewed the guidelines for How to Contribute and my code conforms to the standards described there to the best of my ability.
• I have created a Jira issue and added the issue ID to my pull request title.
• I have given Solr maintainers access to contribute to my PR branch.
• I have developed this patch against the main branch.
• I have run ./gradlew check.
• I have added tests for my changes.
• I have added documentation for the Reference Guide
• I have added a changelog entry for my change

[dsmiley]

looks good; thanks