janhoy commented on PR #4177:
URL: https://github.com/apache/solr/pull/4177#issuecomment-5714351887

   Regarding the "commands" format that is lost with V2, I have given it some 
more thought (see slack), and think we should abandon it, i.e. let it die with 
V1 removal. For the JSON variant that is because it requires non-standard JSON 
with repeating keys and strict ordering. The other reason, for which I also 
think we should get rid of the XML commands, is that mixing adds, deletes, 
commits, optimize etc in one huge POST body is far from RESTful. We should 
instead make sure V2 APIs can do all that the command syntax currently does.
   
   Wrt the separate V2 ref-guide update page, I'm not sure I love it. Are we 
going to add duplicate doc pages based to the collections API, schema API, 
healthcheck API etc as well? Lots of info is repetition. I get that the update 
APIs are somewhat different which may get confusing, but I'd prefer if we could 
re-organize the existing Update page to more naturally describe both. Then of 
course after v1 removal in 11.0 (?) many pages will need to be rewritten / 
cleaned up.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: [email protected]

For queries about this service, please contact Infrastructure at:
[email protected]


---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to