[DOC-14217] Add New Query Settings for Plan Stability - Server 8.5

modules/manage/pages/manage-settings/query-ui-settings.adoc

@@ -175,7 +175,7 @@ If a query uses a sequential scan and a data node becomes unavailable, the query
 
 == Query Optimization
 
-Configure rules for cost optimizer behavior and replica usage. 
+Configure rules for cost optimizer behavior. 
 
 [cols="1,2,1",options="header"]
 |===
@@ -190,6 +190,45 @@ a| Determines whether to use the xref:n1ql:n1ql-language-reference/cost-based-op
 | Selected (Enabled)
 |===
 
+== Plan Stability
+[.status]#Couchbase Server 8.5#
+
+Configure the mode and error policy for xref:n1ql:n1ql-manage/query-plan-stability.adoc[Query Plan Stability].
+
+[cols="1,2,1",options="header"]
+|===
+| Setting | Description | Default Value
+
+| *Plan Stability*
+
+a| Determines whether to save execution plans to disk, and for which statement types.
+
+Select 1 of the following:
+
+* `Off`: Does not save plans to disk.
+* `On Prepared Statements`: Saves plans to disk for all prepared statements.
+* `On All Statements`: Saves plans to disk for all queries, including prepared statements and ad hoc queries.
+* `Frozen`: Does not save plans to disk for new ad hoc queries, but allows the use of existing saved plans.
+
+For more information, see xref:n1ql:n1ql-manage/query-plan-stability.adoc#plan-stability-modes[Plan Stability Modes].
+
+| `Off`
+
+| *Plan Stability Error Policy*
+
+a| Determines how to handle a query when a saved plan is unavailable.
+
+Select 1 of the following:
+
+* `Strict`: Stops execution and returns the error to the application.
+* `Moderate`: Generates a new plan to execute the statement, but keeps the original saved plan.
+* `Flexible`: Generates a new plan to execute the statement and overwrites the saved plan with the new one.
+
+For more information, see xref:n1ql:n1ql-manage/query-plan-stability.adoc#error-policies[Error Policies].
+
+| `Moderate` (Greyed out if *Plan Stability* is `Off`)
+|===
+
 == Query Settings via CLI
 
 You can set all of the cluster-level query settings, except for the CURL access control settings, using the xref:cli:cbcli/couchbase-cli-setting-query.adoc[setting-query] command.

preview/DOC-14217-add-plan-stability-settings.yml

@@ -0,0 +1,27 @@
+sources:
+    docs-devex:
+      branches: DOC-14217-query-plan-stability
+
+#    docs-analytics:
+#      branches: release/8.0
+
+    couchbase-cli:
+      url: https://github.com/couchbaselabs/couchbase-cli-doc
+      branches: master
+      startPaths: docs/
+
+#    backup:
+#      branches: master
+#      startPaths: docs/
+
+    cb-swagger:
+      url: https://github.com/couchbaselabs/cb-swagger
+      branches: release/8.5
+      start_path: docs
+
+  # Minimal SDK build
+#    docs-sdk-common:
+#      branches: [release/8.0]
+#    docs-sdk-java:
+#      branches: [3.11]
+