[ 
https://issues.apache.org/jira/browse/SOLR-13942?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17051236#comment-17051236
 ] 

Andrzej Bialecki commented on SOLR-13942:
-----------------------------------------

[~noble.paul] and [~ichattopadhyaya] - I understand Jan's concern here, because 
you've just added a new, powerful and totally undocumented API to Solr just a 
moment before the release, and when he pushed back you largely ignored his 
concerns instead of trying to find a better solution.

So, in CTR workflow, if there are valid concerns and the original committer 
ignores them, IMHO a veto is a justified way to draw his attention and force 
the discussion, in order to arrive at a better solution.

Having said that, I also accept that there is at least a temporary need in 8x 
for accessing the full content of Solr state data (wherever it might be, in ZK 
or in a DB or elsewhere) without actually accessing the ZK native API, so I see 
the merit for adding an API like this.

The API that was added has no documentation whatsoever, and only rudimentary 
testing. I don't buy the argument that since it's an expert API it should be 
intentionally undocumented - this smells of security through obscurity, and 
builds a tech debt in terms of the missing docs for public APIs. Just from this 
point of view the work here is NOT done - we need the documentation and more 
comprehensive tests.

Here's my strawman proposal how to proceed:
 * revert (or don't revert) but address Jan's concerns before the 8.5 release, 
plus:
 * mark the API as experimental, both in the docs and in the API output
 * add RefGuide documentation
 * add more tests - this is a powerful new API and it has just one basic test? 
come on.

> /api/cluster/zk/* to fetch raw ZK data
> --------------------------------------
>
>                 Key: SOLR-13942
>                 URL: https://issues.apache.org/jira/browse/SOLR-13942
>             Project: Solr
>          Issue Type: New Feature
>          Components: v2 API
>            Reporter: Noble Paul
>            Assignee: Noble Paul
>            Priority: Blocker
>             Fix For: 8.5
>
>          Time Spent: 20m
>  Remaining Estimate: 0h
>
> example
> download the {{state.json}} of
> {code}
> GET http://localhost:8983/api/cluster/zk/collections/gettingstarted/state.json
> {code}
> get a list of all children under {{/live_nodes}}
> {code}
> GET http://localhost:8983/api/cluster/zk/live_nodes
> {code}
> If the requested path is a node with children show the list of child nodes 
> and their meta data



--
This message was sent by Atlassian Jira
(v8.3.4#803005)

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

Reply via email to