[DOCS][OAS] Add data view swap saved object references and preview AP…

…Is (elastic#187927) (cherry picked from commit 8dc2860)
lcawl · Jul 26, 2024 · ec6e7be · ec6e7be
1 parent ee1062a
commit ec6e7be
Show file tree

Hide file tree

Showing 48 changed files with 1,065 additions and 2,251 deletions.
diff --git a/docs/api/data-views.asciidoc b/docs/api/data-views.asciidoc
@@ -1,7 +1,7 @@
 [[data-views-api]]
 == Data views API
 
-experimental[] Manage data views, formerly known as {kib} index patterns.
+Manage data views, formerly known as {kib} index patterns.
 
 WARNING: Do not write documents directly to the `.kibana` index. When you write directly
 to the `.kibana` index, the data becomes corrupted and permanently breaks future {kib} versions.

diff --git a/docs/api/data-views/create.asciidoc b/docs/api/data-views/create.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Create data view</titleabbrev>
 ++++
 
-experimental[] Create data views.
+Create data views.
 
 [NOTE]
 ====

diff --git a/docs/api/data-views/default-get.asciidoc b/docs/api/data-views/default-get.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Get default data view</titleabbrev>
 ++++
 
-experimental[] Retrieve a default data view ID. Kibana UI uses the default data view unless user picks a different one.
+Retrieve a default data view ID. Kibana UI uses the default data view unless user picks a different one.
 
 [NOTE]
 ====

diff --git a/docs/api/data-views/default-set.asciidoc b/docs/api/data-views/default-set.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Set default data view</titleabbrev>
 ++++
 
-experimental[] Set a default data view ID. Kibana UI will use the default data view unless user picks a different one. 
+Set a default data view ID. Kibana UI will use the default data view unless user picks a different one. 
 The API doesn't validate if given `data_view_id` is a valid id. 
 
 [NOTE]

diff --git a/docs/api/data-views/delete.asciidoc b/docs/api/data-views/delete.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Delete data view</titleabbrev>
 ++++
 
-experimental[] Delete data views.
+Delete data views.
 
 WARNING: Once you delete a data view, _it cannot be recovered_.
 

diff --git a/docs/api/data-views/get-all.asciidoc b/docs/api/data-views/get-all.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Get all data views</titleabbrev>
 ++++
 
-experimental[] Retrieve a list of all data views.
+Retrieve a list of all data views.
 
 [NOTE]
 ====

diff --git a/docs/api/data-views/get.asciidoc b/docs/api/data-views/get.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Get data view</titleabbrev>
 ++++
 
-experimental[] Retrieve a single data view by ID.
+Retrieve a single data view by ID.
 
 [NOTE]
 ====

diff --git a/docs/api/data-views/runtime-fields/create.asciidoc b/docs/api/data-views/runtime-fields/create.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Create runtime field</titleabbrev>
 ++++
 
-experimental[] Create a runtime field
+Create a runtime field
 
 [[data-views-runtime-field-create-request]]
 ==== Request

diff --git a/docs/api/data-views/runtime-fields/delete.asciidoc b/docs/api/data-views/runtime-fields/delete.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Delete runtime field</titleabbrev>
 ++++
 
-experimental[] Delete a runtime field from a data view.
+Delete a runtime field from a data view.
 
 [[data-views-runtime-field-api-delete-request]]
 ==== Request

diff --git a/docs/api/data-views/runtime-fields/get.asciidoc b/docs/api/data-views/runtime-fields/get.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Get runtime field</titleabbrev>
 ++++
 
-experimental[] Get a runtime field
+Get a runtime field
 
 [NOTE]
 ====

diff --git a/docs/api/data-views/runtime-fields/update.asciidoc b/docs/api/data-views/runtime-fields/update.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Update runtime field</titleabbrev>
 ++++
 
-experimental[] Update an existing runtime field
+Update an existing runtime field
 
 
 [[data-views-runtime-field-update-request]]

diff --git a/docs/api/data-views/runtime-fields/upsert.asciidoc b/docs/api/data-views/runtime-fields/upsert.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Upsert runtime field</titleabbrev>
 ++++
 
-experimental[] Create or update an existing runtime field
+Create or update an existing runtime field
 
 
 [[data-views-runtime-field-upsert-request]]

diff --git a/docs/api/data-views/update-fields.asciidoc b/docs/api/data-views/update-fields.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Update data view fields metadata</titleabbrev>
 ++++
 
-experimental[] Update fields presentation metadata, such as `count`,
+Update fields presentation metadata, such as `count`,
 `customLabel`, `customDescription`, and `format`. You can update multiple fields in one request. Updates
 are merged with persisted metadata. To remove existing metadata, specify `null` as the value.
 

diff --git a/docs/api/data-views/update.asciidoc b/docs/api/data-views/update.asciidoc
@@ -4,7 +4,7 @@
 <titleabbrev>Update data view</titleabbrev>
 ++++
 
-experimental[] Update part of an data view. Only the specified fields are updated in the
+Update part of an data view. Only the specified fields are updated in the
 data view. Unspecified fields stay as they are persisted.
 
 [NOTE]

diff --git a/oas_docs/.spectral.yaml b/oas_docs/.spectral.yaml
@@ -48,7 +48,7 @@ rules:
     description: Response code 200 should have at least one example.
     message: "Each response body should have a realistic example. It must not contain any sensitive or confidential data."
     severity: info
-    given: $.paths[*].[*].responses.[200].content.[application/json]
+    given: $.paths[*][*].responses.[200].content.[application/json]
     then:
       field: examples
       function: defined
@@ -57,7 +57,7 @@ rules:
     description: Operations should not have x-internal extension.
     message: "Do not publish x-internal operations"
     severity: error
-    given: $.paths[*].[get,put,post,delete,options,head,patch,trace]
+    given: $.paths[*][*]
     then:
       field: x-internal
       function: undefined
@@ -67,13 +67,13 @@ rules:
     message: "Each operation should have a summary"
     severity: error
     recommended: true
-    given: $.paths[*].[get,put,post,delete,options,head,patch,trace]
+    given: $.paths[*][*]
     then:
       field: summary
       function: defined   
   operation-summary-length:
     description: Operation summary should be between 5 and 45 characters
-    given: "$.paths[*].[get,put,post,delete,options,head,patch,trace]"
+    given: "$.paths[*][*]"
     then:
       field: summary
       function: length
-Original file line number
+Diff line change
@@ Expand Up / @@ -4,7 +4,7 @@ @@
     <titleabbrev>Create data view</titleabbrev>
     ++++
-    experimental[] Create data views.
+    Create data views.
     [NOTE]
     ====
@@ Expand Down @@