[8.5] [DOCS] Alert limit for cases (#145950) (#146337)

# Backport

This will backport the following commits from `main` to `8.5`:
- [[DOCS] Alert limit for cases
(#145950)](https://github.com/elastic/kibana/pull/145950)

<!--- Backport version: 8.9.7 -->

### Questions ?
Please refer to the [Backport tool
documentation](https://github.com/sqren/backport)

<!--BACKPORT [{"author":{"name":"Lisa
Cawley","email":"lcawley@elastic.co"},"sourceCommit":{"committedDate":"2022-11-24T16:56:45Z","message":"[DOCS]
Alert limit for cases
(#145950)","sha":"876f1b9ac88e1206bd4429b5d12c8c8f22c5eb45","branchLabelMapping":{"^v8.7.0$":"main","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","docs","Feature:Cases","auto-backport","v8.6.0","v8.7.0","v8.5.2"],"number":145950,"url":"https://github.com/elastic/kibana/pull/145950","mergeCommit":{"message":"[DOCS]
Alert limit for cases
(#145950)","sha":"876f1b9ac88e1206bd4429b5d12c8c8f22c5eb45"}},"sourceBranch":"main","suggestedTargetBranches":["8.5"],"targetPullRequestStates":[{"branch":"8.6","label":"v8.6.0","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"url":"https://github.com/elastic/kibana/pull/146321","number":146321,"state":"MERGED","mergeCommit":{"sha":"249b3ebdae329675612186900a56a1f26b27b8ac","message":"[8.6]
[DOCS] Alert limit for cases (#145950)
(#146321)"}},{"branch":"main","label":"v8.7.0","labelRegex":"^v8.7.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/145950","number":145950,"mergeCommit":{"message":"[DOCS]
Alert limit for cases
(#145950)","sha":"876f1b9ac88e1206bd4429b5d12c8c8f22c5eb45"}},{"branch":"8.5","label":"v8.5.2","labelRegex":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

docs/api/cases/cases-api-add-comment.asciidoc

@@ -19,6 +19,10 @@ You must have `all` privileges for the *Cases* feature in the *Management*,
 <<kibana-feature-privileges,{kib} feature privileges>>, depending on the
 `owner` of the case you're updating.
 
+=== {api-description-title}
+
+NOTE: Each case can have a maximum of 1,000 alerts.
+
 === {api-path-parms-title}
 
 `<case_id>`::

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

@@ -1477,7 +1477,7 @@
       "post": {
         "summary": "Adds a comment or alert to a case.",
         "operationId": "addCaseComment",
-        "description": "You must have `all` privileges for the **Cases** feature in the **Management**, **Observability**, or **Security** section of the Kibana feature privileges, depending on the owner of the case you're creating.\n",
+        "description": "You must have `all` privileges for the **Cases** feature in the **Management**, **Observability**, or **Security** section of the Kibana feature privileges, depending on the owner of the case you're creating. NOTE: Each case can have a maximum of 1,000 alerts.\n",
         "tags": [
           "cases"
         ],

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

@@ -948,7 +948,7 @@ paths:
       summary: Adds a comment or alert to a case.
       operationId: addCaseComment
       description: |
-        You must have `all` privileges for the **Cases** feature in the **Management**, **Observability**, or **Security** section of the Kibana feature privileges, depending on the owner of the case you're creating.
+        You must have `all` privileges for the **Cases** feature in the **Management**, **Observability**, or **Security** section of the Kibana feature privileges, depending on the owner of the case you're creating. NOTE: Each case can have a maximum of 1,000 alerts.
       tags:
         - cases
       parameters:

x-pack/plugins/cases/docs/openapi/paths/s@{spaceid}@api@cases@{caseid}@comments.yaml

@@ -5,6 +5,7 @@ post:
     You must have `all` privileges for the **Cases** feature in the
     **Management**, **Observability**, or **Security** section of the Kibana
     feature privileges, depending on the owner of the case you're creating.
+    NOTE: Each case can have a maximum of 1,000 alerts.
   tags:
     - cases
   parameters: