[DOCS][OAS] Add descriptions, tags, deprecation to connector APIs (elastic#184956)

(cherry picked from commit e6795e5)

Author: lcawl

oas_docs/output/kibana.yaml

@@ -8,5 +8,12 @@
 import { schema } from '@kbn/config-schema';
 
 export const connectorTypesQuerySchema = schema.object({
-  feature_id: schema.maybe(schema.string()),
+  feature_id: schema.maybe(
+    schema.string({
+      meta: {
+        description:
+          'A filter to limit the retrieved connector types to those that support a specific feature (such as alerting or cases).',
+      },
+    })
+  ),
 });

x-pack/plugins/actions/common/routes/connector/apis/connector_types/schemas/v1.ts

@@ -8,5 +8,7 @@
 import { schema } from '@kbn/config-schema';
 
 export const getConnectorParamsSchema = schema.object({
-  id: schema.string(),
+  id: schema.string({
+    meta: { description: 'An identifier for the connector.' },
+  }),
 });

x-pack/plugins/actions/common/routes/connector/apis/get/schemas/v1.ts

@@ -13,15 +13,7 @@ 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/actions/docs/openapi/` folder:
-
-```
-npx swagger-cli validate entrypoint.yaml
-npx swagger-cli validate entrypoint_serverless.yaml
-```
-
-Then you can generate the `bundled` files by running the following commands:
+You can generate the `bundled` files by running the following commands:
 
 ```
 npx @redocly/cli bundle entrypoint.yaml --output bundled.yaml --ext yaml
@@ -30,9 +22,4 @@ npx @redocly/cli bundle entrypoint_serverless.yaml --output bundled_serverless.y
 npx @redocly/cli bundle entrypoint_serverless.yaml --output bundled_serverless.json --ext json
 ```
 
-You can run additional linting with the following command:
-
-```
-npx @redocly/cli lint bundled.json
-npx @redocly/cli lint bundled_serverless.json
-```
+Then join these files with the rest of the Kibana APIs per `oas_docs/README.md`