Apache Solr open-source search software
SOLR-14986: Add warning to ref guide that using 'properties.name' is an expert option
Erick Erickson93ecd0fa0a35
diff --git a/solr/solr-ref-guide/src/collection-management.adoc b/solr/solr-ref-guide/src/collection-management.adocindex c1d3af0e1ac..14e32b6e395 100644--- a/solr/solr-ref-guide/src/collection-management.adoc+++ b/solr/solr-ref-guide/src/collection-management.adoc@@ -90,6 +90,11 @@ Please note that <<realtime-get.adoc#realtime-get,RealTime Get>> or retrieval by`property._name_=_value_`::Set core property _name_ to _value_. See the section <<defining-core-properties.adoc#defining-core-properties,Defining core.properties>> for details on supported properties and values.+[WARNING]+====+The entries in each core.properties file are vital for Solr to function correctly. Overriding entries can result in unusable collections. Altering these entries by specifying `property._name_=_value_` is an expert-level option and should only be used if you have a thorough understanding of the consequences.+====+`async`::Request ID to track this action which will be <<collections-api.adoc#asynchronous-calls,processed asynchronously>>.diff --git a/solr/solr-ref-guide/src/replica-management.adoc b/solr/solr-ref-guide/src/replica-management.adocindex 6896995c03e..14dc2647fa5 100644--- a/solr/solr-ref-guide/src/replica-management.adoc+++ b/solr/solr-ref-guide/src/replica-management.adoc@@ -78,6 +78,11 @@ The number of `pull` replicas that should be created (optional, defaults to 1 if`property._name_=_value_`::Set core property _name_ to _value_. See <<defining-core-properties.adoc#defining-core-properties,Defining core.properties>> for details about supported properties and values.+[WARNING]+====+The entries in each core.properties file are vital for Solr to function correctly. Overriding entries can result in unusable collections. Altering these entries by specifying `property._name_=_value_` is an expert-level option and should only be used if you have a thorough understanding of the consequences.+====+`waitForFinalState`::If `true`, the request will complete only when all affected replicas become active. The default is `false`, which means that the API will return the status of the single action, which may be before the new replica is online and active.