[DOCS][OAS] Add descriptions, tags, deprecation to connector APIs

[lcawl]

Summary

Relates to #180056, #182779

This PR:

• copies the existing descriptions from https://github.com/elastic/kibana/tree/main/x-pack/plugins/actions/docs/openapi into the code so that they'll be included in the generated OpenAPI documents
• adds the oas-tag values so that the output contains tags
• adds the deprecated: true qualifiers to the legacy APIs per [HTTP/OAS] Support deprecated field #181240
• removes the /s// version of the paths from the openAPI document, since per discussions elsewhere we'll cover that in an introductory page rather than repeat for every endpoint

NOTE: I've commented out details about the kibana feature privileges since I think we'll need to quality the difference between privileges in serverless and stateful contexts.

How to test

Per #181277:

1. Start Elasticsearch (e.g. yarn es snapshot --license trial)
2. Add server.oas.enabled: true to kibana.dev.yml
3. Start Kibana (e.g. yarn start --no-base-path)
4. curl -s -uelastic http://localhost:5601/api/oas\?pathStartsWith\=/api/actions | jq > test1.json

The output will contain info like this:

      "delete": {
        "summary": "Delete a connector",
        "tags": [ "connectors" ],
        "description": "WARNING: When you delete a connector, it cannot be recovered.",
...
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "An identifier for the connector."

[apmmachine]

🤖 GitHub comments

Expand to view the GitHub comments

Just comment with:

• /oblt-deploy : Deploy a Kibana instance using the Observability test environments.
• run docs-build : Re-trigger the docs validation. (use unformatted text in the comment!)

[elasticmachine]

Pinging @elastic/response-ops (Team:ResponseOps)

[adcoelho]

Tested and is working as expected 👍

[kibana-ci]

💚 Build Succeeded

• Buildkite Build
• Commit: 9d31338

Metrics [docs]

✅ unchanged

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream

[kibanamachine]

💔 All backports failed

Status	Branch	Result
❌	8.15	Backport failed because of merge conflicts You might need to backport the following PRs to 8.15: - [OAS][DOCS] Add x-topics info about running APIs in spaces (#189144) - [DOCS][OAS] Add data view swap saved object references and preview APIs (#187927)

Manual backport

To create the backport manually run:

node scripts/backport --pr 184956

Questions ?

Please refer to the Backport tool documentation

[lcawl]

💚 All backports created successfully

Status	Branch	Result
✅	8.15

Note: Successful backport PRs will be merged automatically after passing CI.

Questions ?

Please refer to the Backport tool documentation