Apache Solr open-source search software
SOLR-15780: Document v2 API as "experimental" (#849)
Jason Gerlowski15dbf12eaeca
diff --git a/solr/CHANGES.txt b/solr/CHANGES.txtindex 01217865b66..562d0355c41 100644--- a/solr/CHANGES.txt+++ b/solr/CHANGES.txt@@ -713,6 +713,9 @@ Other Changes* SOLR-16101: Add empty constructor for SolrInputDocument (Anshum Gupta)+* SOLR-15780: The v2 API is now treated as "experimental". It may change in backwards-incompatible ways in subsequent releases+ as it expands to cover additional functionality and prepares to supplant the v1 API. (Jason Gerlowski)+Bug Fixes---------------------* SOLR-15849: Fix the connection reset problem caused by the incorrect use of 4LW with \n when monitoring zooKeeper statusdiff --git a/solr/solr-ref-guide/modules/configuration-guide/pages/v2-api.adoc b/solr/solr-ref-guide/modules/configuration-guide/pages/v2-api.adocindex cafddbc9e7c..11dd8c11e56 100644--- a/solr/solr-ref-guide/modules/configuration-guide/pages/v2-api.adoc+++ b/solr/solr-ref-guide/modules/configuration-guide/pages/v2-api.adoc@@ -19,9 +19,11 @@[[top-v2-api]]The v2 API is a modernized self-documenting API interface covering most current Solr APIs.It is anticipated that once the v2 API reaches full coverage, and Solr-internal API usages like SolrJ and the Admin UI have been converted from the old API to the v2 API, the old API will eventually be retired.+Today, the two API styles coexist, and all the old APIs will continue to work without any change.+You can disable all v2 API endpoints if desired by starting your servers with this system property: `-Ddisable.v2.api=true`.-For now the two API styles will coexist, and all the old APIs will continue to work without any change.-You can disable all v2 API endpoints by starting your servers with this system property: `-Ddisable.v2.api=true`.+NOTE: The v2 API is classified as "experimental".+It may change in backwards-incompatible ways as it evolves to cover additional functionality.The old API and the v2 API differ in three principle ways: