epugh commented on code in PR #1876:
URL: https://github.com/apache/solr/pull/1876#discussion_r1311843664


##########
dev-docs/apis.adoc:
##########
@@ -0,0 +1,81 @@
+= APIs in Solr
+:toc: left
+
+Solr's codebase currently has a handful of ways of defining APIs.
+This complexity stems largely from two ongoing transitions:
+1. Away from our "v1" APIs and towards the new "v2" API. 
+2. Away from a legacy API framework towards the off-the-shelf JAX-RS library 
for implementing our v2 APIs
+
+As these transitions complete, this complexity should simplify considerably.

Review Comment:
   passive language?  though I really don't know that we have a strong 
editorial stance on writing sytle!



-- 
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: issues-unsubscr...@solr.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org


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

Reply via email to