[DOCS][OAS] Add cases to Kibana API bundle (elastic#189020)

(cherry picked from commit d86e139)

Author: lcawl

oas_docs/makefile

@@ -15,12 +15,12 @@
 
 .PHONY: api-docs
 api-docs: ## Generate kibana.yaml
-	@npx @redocly/cli join "kibana.info.yaml" "../x-pack/plugins/observability_solution/apm/docs/openapi/apm.yaml" "../x-pack/plugins/actions/docs/openapi/bundled.yaml" "../src/plugins/data_views/docs/openapi/bundled.yaml" "../x-pack/plugins/ml/common/openapi/ml_apis.yaml" "../packages/core/saved-objects/docs/openapi/bundled.yaml" "../x-pack/plugins/observability_solution/slo/docs/openapi/slo/bundled.yaml" "bundle.json" -o "output/kibana.yaml" --prefix-components-with-info-prop title
+	@npx @redocly/cli join "kibana.info.yaml" "../x-pack/plugins/observability_solution/apm/docs/openapi/apm.yaml" "../x-pack/plugins/cases/docs/openapi/bundled.yaml" "../x-pack/plugins/actions/docs/openapi/bundled.yaml" "../src/plugins/data_views/docs/openapi/bundled.yaml" "../x-pack/plugins/ml/common/openapi/ml_apis.yaml" "../packages/core/saved-objects/docs/openapi/bundled.yaml" "../x-pack/plugins/observability_solution/slo/docs/openapi/slo/bundled.yaml" "bundle.json" -o "output/kibana.yaml" --prefix-components-with-info-prop title
 
 .PHONY: api-docs-stateful
 api-docs-stateful: ## Generate only kibana.yaml
-	@npx @redocly/cli join "kibana.info.yaml" "../x-pack/plugins/observability_solution/apm/docs/openapi/apm.yaml" "../x-pack/plugins/actions/docs/openapi/bundled.yaml" "../src/plugins/data_views/docs/openapi/bundled.yaml" "../x-pack/plugins/ml/common/openapi/ml_apis.yaml" "../packages/core/saved-objects/docs/openapi/bundled.yaml" "../x-pack/plugins/observability_solution/slo/docs/openapi/slo/bundled.yaml" "bundle.json" -o "output/kibana.yaml" --prefix-components-with-info-prop title
-# Temporarily omit "../x-pack/plugins/alerting/docs/openapi/bundled.yaml" and "../x-pack/plugins/cases/docs/openapi/bundled.yaml" due to OAS version
+	@npx @redocly/cli join "kibana.info.yaml" "../x-pack/plugins/observability_solution/apm/docs/openapi/apm.yaml" "../x-pack/plugins/cases/docs/openapi/bundled.yaml" "../x-pack/plugins/actions/docs/openapi/bundled.yaml" "../src/plugins/data_views/docs/openapi/bundled.yaml" "../x-pack/plugins/ml/common/openapi/ml_apis.yaml" "../packages/core/saved-objects/docs/openapi/bundled.yaml" "../x-pack/plugins/observability_solution/slo/docs/openapi/slo/bundled.yaml" "bundle.json" -o "output/kibana.yaml" --prefix-components-with-info-prop title
+# Temporarily omit "../x-pack/plugins/alerting/docs/openapi/bundled.yaml" due to OAS version
 # Temporarily omit "../x-pack/plugins/fleet/common/openapi/bundled.yaml" due to internals tag and tag sorting
 
 .PHONY: api-docs-lint

oas_docs/output/kibana.yaml

@@ -13,22 +13,11 @@ A guide about the openApi specification can be found at [https://swagger.io/docs
 
 ## Tools
 
-It is possible to validate the docs before bundling them with the following
-command in the `x-pack/plugins/cases/docs/openapi/` folder:
-
-  ```bash
-    npx swagger-cli validate entrypoint.yaml
-  ```
-
-Then you can generate the `bundled` files by running the following commands:
+Generate the `bundled` files by running the following commands:
 
   ```bash
     npx @redocly/cli bundle entrypoint.yaml --output bundled.yaml --ext yaml
     npx @redocly/cli bundle entrypoint.yaml --output bundled.json --ext json
   ```
 
-After generating the json bundle ensure that it is also valid by running the following command:
-
-  ```bash
-     npx @redocly/cli lint bundled.json
-  ```
+Then join these files with the rest of the Kibana APIs per `oas_docs/README.md`

x-pack/plugins/cases/docs/openapi/README.md

@@ -4,5 +4,4 @@ description: An identifier for the alert.
 required: true
 schema:
   type: string
-  examples:
-    - 09f0c261e39e36351d75995b78bb83673774d1bc2cca9df2d15f0e5c0a99a540
+  example: 09f0c261e39e36351d75995b78bb83673774d1bc2cca9df2d15f0e5c0a99a540

x-pack/plugins/cases/docs/openapi/bundled.json

@@ -4,5 +4,4 @@ description: The identifier for the case. To retrieve case IDs, use the find cas
 required: true
 schema:
   type: string
-  examples:
-    - 9c235210-6834-11ea-a78c-6ffb38a34414
+  example: 9c235210-6834-11ea-a78c-6ffb38a34414

x-pack/plugins/cases/docs/openapi/bundled.yaml

@@ -4,9 +4,8 @@ description: Filters the returned cases by category.
 schema:
   oneOf:
     - type: string
+      example: my-category
     - type: array
       items:
         type: string
-      maxItems: 100
-      examples:
-        - [ my-category ]
+      maxItems: 100

x-pack/plugins/cases/docs/openapi/components/parameters/alert_id.yaml

@@ -6,5 +6,4 @@ description: >
 required: true 
 schema:
   type: string
-  examples:
-    - '71ec1870-725b-11ea-a0b2-c51ea50a58e2'
+  example: '71ec1870-725b-11ea-a0b2-c51ea50a58e2'

x-pack/plugins/cases/docs/openapi/components/parameters/case_id.yaml

@@ -4,5 +4,4 @@ description: An identifier for the configuration.
 required: true
 schema:
   type: string
-  examples:
-    - 3297a0f0-b5ec-11ec-b141-0fdb20a7f9a9
+  example: 3297a0f0-b5ec-11ec-b141-0fdb20a7f9a9