You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@solr.apache.org by Jason Gerlowski <ge...@gmail.com> on 2022/10/12 19:26:13 UTC

Deprecation/Backcompat for Internal+Undocumented APIs

Hi all,

Does our normal deprecation and backcompat policy around APIs, i.e.
deprecate in major version (N-1) in order to remove/modify in major version
N, apply to undocumented/internal APIs?

I stumbled across an internal core-admin API (/admin/cores?action=INVOKE)
on 'main' recently that was added in support of the "snitch" functionality
in the Rule Based Replica Placement functionality that was removed in 9.0.
The API eluded removal as a part of that ticket I guess, so now I'm
wondering whether we're stuck with it until 10.0, or whether this is a
reasonable exception to our normal backcompat policy? [1] [2]

Best,

Jason

[1] https://issues.apache.org/jira/browse/SOLR-14930 - removal of RBRP in
9.0
[2] https://issues.apache.org/jira/browse/SOLR-16459 - proposed removal of
INVOKE API

Re: Deprecation/Backcompat for Internal+Undocumented APIs

Posted by Eric Pugh <ep...@opensourceconnections.com>.
Agreed….   

> On Oct 12, 2022, at 11:45 PM, Noble Paul <no...@gmail.com> wrote:
> 
> They are internal/undocumented APIs .IMHO we shoould not wait until 10.0
> 
> On Thu, Oct 13, 2022 at 6:26 AM Jason Gerlowski <ge...@gmail.com>
> wrote:
> 
>> Hi all,
>> 
>> Does our normal deprecation and backcompat policy around APIs, i.e.
>> deprecate in major version (N-1) in order to remove/modify in major version
>> N, apply to undocumented/internal APIs?
>> 
>> I stumbled across an internal core-admin API (/admin/cores?action=INVOKE)
>> on 'main' recently that was added in support of the "snitch" functionality
>> in the Rule Based Replica Placement functionality that was removed in 9.0.
>> The API eluded removal as a part of that ticket I guess, so now I'm
>> wondering whether we're stuck with it until 10.0, or whether this is a
>> reasonable exception to our normal backcompat policy? [1] [2]
>> 
>> Best,
>> 
>> Jason
>> 
>> [1] https://issues.apache.org/jira/browse/SOLR-14930 - removal of RBRP in
>> 9.0
>> [2] https://issues.apache.org/jira/browse/SOLR-16459 - proposed removal of
>> INVOKE API
>> 
> 
> 
> -- 
> -----------------------------------------------------
> Noble Paul

_______________________
Eric Pugh | Founder & CEO | OpenSource Connections, LLC | 434.466.1467 | http://www.opensourceconnections.com <http://www.opensourceconnections.com/> | My Free/Busy <http://tinyurl.com/eric-cal>  
Co-Author: Apache Solr Enterprise Search Server, 3rd Ed <https://www.packtpub.com/big-data-and-business-intelligence/apache-solr-enterprise-search-server-third-edition-raw>	
This e-mail and all contents, including attachments, is considered to be Company Confidential unless explicitly stated otherwise, regardless of whether attachments are marked as such.


Re: Deprecation/Backcompat for Internal+Undocumented APIs

Posted by Noble Paul <no...@gmail.com>.
They are internal/undocumented APIs .IMHO we shoould not wait until 10.0

On Thu, Oct 13, 2022 at 6:26 AM Jason Gerlowski <ge...@gmail.com>
wrote:

> Hi all,
>
> Does our normal deprecation and backcompat policy around APIs, i.e.
> deprecate in major version (N-1) in order to remove/modify in major version
> N, apply to undocumented/internal APIs?
>
> I stumbled across an internal core-admin API (/admin/cores?action=INVOKE)
> on 'main' recently that was added in support of the "snitch" functionality
> in the Rule Based Replica Placement functionality that was removed in 9.0.
> The API eluded removal as a part of that ticket I guess, so now I'm
> wondering whether we're stuck with it until 10.0, or whether this is a
> reasonable exception to our normal backcompat policy? [1] [2]
>
> Best,
>
> Jason
>
> [1] https://issues.apache.org/jira/browse/SOLR-14930 - removal of RBRP in
> 9.0
> [2] https://issues.apache.org/jira/browse/SOLR-16459 - proposed removal of
> INVOKE API
>


-- 
-----------------------------------------------------
Noble Paul