DOC-13510: Fix external example refs (#205)

* Update Query Settings to expect JSON examples
* Build output documentation

Author: simon-dew

docs/modules/n1ql-rest-admin/pages/index.adoc

@@ -6795,7 +6795,6 @@ a¦
 --
 ifdef::alt-markdown-links[]
 [queryNumAtrs]: #queryNumAtrs
-[numatrs_req]: #numatrs_req
 
 endif::alt-markdown-links[]
 Specifies the total number of [active transaction records][additional-storage-use].
@@ -6806,11 +6805,7 @@ Specifies the total number of [active transaction records][additional-storage-us
 The [cluster-level][queryNumAtrs] `queryNumAtrs` setting specifies this property for the whole cluster.
 When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster.
 
-In addition, the [request-level][numatrs_req] `numatrs` parameter specifies this property per request.
-The minimum of that and the node-level `numatrs` setting is applied.
-
 [queryNumAtrs]: ../n1ql-rest-settings/index.html#queryNumAtrs
-[numatrs_req]: ../n1ql-rest-query/index.html#numatrs_req
 // end::desc-more[]
 --
 

docs/modules/n1ql-rest-query/pages/index.adoc

@@ -1993,31 +1993,11 @@ a¦
 
 [markdown]
 --
-ifdef::alt-markdown-links[]
-[numatrs-srv]: #numatrs-srv
-[queryNumAtrs]: #queryNumAtrs
-
-endif::alt-markdown-links[]
-Specifies the total number of [active transaction records][additional-storage-use].
-Must be a positive integer.
-
-[additional-storage-use]: /server/8.0/learn/data/transactions.html#active-transaction-record-entries
-
-// tag::desc-more[]
-The [node-level][numatrs-srv] `numatrs` setting specifies the default for this parameter for a single node.
-The request-level parameter overrides the node-level setting.
-
-In addition, the [cluster-level][queryNumAtrs] `queryNumAtrs` setting specifies the default for this parameter for the whole cluster.
-When you change the cluster-level setting, the node-level setting is overwritten for all nodes in the cluster.
-
-[numatrs-srv]: ../n1ql-rest-admin/index.html#numatrs-srv
-[queryNumAtrs]: ../n1ql-rest-settings/index.html#queryNumAtrs
-// end::desc-more[]
+Reserved for future use.
+This parameter is ignored and has no effect.
 --
 
 [%hardbreaks]
-*Default:* `1024`
-*Example:* `512`
 {blank}
 a¦ Integer (int32)
 
@@ -2488,10 +2468,11 @@ ifdef::alt-markdown-links[]
 [queryTimeout]: #queryTimeout
 
 endif::alt-markdown-links[]
-Maximum time to spend on the request before timing out.
+Maximum time to spend on the request before timing out (s).
 
 The value for this parameter is a string.
-Its format includes an amount and a mandatory unit, e.g. `10ms` (10 milliseconds) or `0.5s` (half a second).
+Its format includes an amount and an optional unit: for example, `10ms` (10 milliseconds) or `0.5s` (half a second).
+If not specified, the default unit is `s` (seconds).
 Valid units are:
 
 * `ns` (nanoseconds)

…examples/query-settings-get-access.jsonc …/examples/query-settings-get-access.jsondocs/modules/n1ql-rest-settings/examples/query-settings-get-access.jsonc renamed to docs/modules/n1ql-rest-settings/examples/query-settings-get-access.json docs/modules/n1ql-rest-settings/examples/query-settings-get-access.jsonc renamed to docs/modules/n1ql-rest-settings/examples/query-settings-get-access.json

@@ -63,7 +63,7 @@ The URL scheme. Use `https` for secure access.
 a| *host*
 a| [markdown]
 --
-The host name or IP address of a node running the Query Service.
+The host name or IP address of any node in the Couchbase cluster.
 --
 
 [%hardbreaks]
@@ -1432,7 +1432,6 @@ a¦
 --
 ifdef::alt-markdown-links[]
 [numatrs-srv]: #numatrs-srv
-[numatrs_req]: #numatrs_req
 
 endif::alt-markdown-links[]
 Specifies the total number of [active transaction records][additional-storage-use] for all Query nodes in the cluster.
@@ -1443,11 +1442,7 @@ Specifies the total number of [active transaction records][additional-storage-us
 The [node-level][numatrs-srv] `numatrs` setting specifies this property for a single node.
 When you change the cluster-level setting, the node-level setting is over-written for all nodes in the cluster.
 
-In addition, there is a [request-level][numatrs_req] `numatrs` parameter.
-If a request includes this parameter, it will be capped by the node-level `numatrs` setting.
-
 [numatrs-srv]: ../n1ql-rest-admin/index.html#numatrs-srv
-[numatrs_req]: ../n1ql-rest-query/index.html#numatrs_req
 // end::desc-more[]
 --
 

…amples/query-settings-get-settings.jsonc …xamples/query-settings-get-settings.jsondocs/modules/n1ql-rest-settings/examples/query-settings-get-settings.jsonc renamed to docs/modules/n1ql-rest-settings/examples/query-settings-get-settings.json docs/modules/n1ql-rest-settings/examples/query-settings-get-settings.jsonc renamed to docs/modules/n1ql-rest-settings/examples/query-settings-get-settings.json

@@ -6,15 +6,15 @@ tasks.register('getExamples') {
                 value: "https://raw.githubusercontent.com/couchbase/query/refs/heads/morpheus/docs/spec/settings/examples")
     ant.echo("Fetching from ${ant.srcUrl}")
     ant.get(dest: "examples", ignoreerrors: "true") {
-      ant.url(url: "${ant.srcUrl}/query-settings-get-access.jsonc")
+      ant.url(url: "${ant.srcUrl}/query-settings-get-access.json")
       ant.url(url: "${ant.srcUrl}/query-settings-get-access.sh")
-      ant.url(url: "${ant.srcUrl}/query-settings-get-settings.jsonc")
+      ant.url(url: "${ant.srcUrl}/query-settings-get-settings.json")
       ant.url(url: "${ant.srcUrl}/query-settings-get-settings.sh")
-      ant.url(url: "${ant.srcUrl}/query-settings-post-access.jsonc")
+      ant.url(url: "${ant.srcUrl}/query-settings-post-access.json")
       ant.url(url: "${ant.srcUrl}/query-settings-post-access.sh")
-      ant.url(url: "${ant.srcUrl}/query-settings-post-settings.jsonc")
+      ant.url(url: "${ant.srcUrl}/query-settings-post-settings.json")
       ant.url(url: "${ant.srcUrl}/query-settings-post-settings.sh")
-      ant.url(url: "${ant.srcUrl}/query-settings-post-snippet.jsonc")
+      ant.url(url: "${ant.srcUrl}/query-settings-post-snippet.json")
     }
   }
 }