[8.x] [Docs] Add breaking change to release notes (#200065) (#200224)

# Backport

This will backport the following commits from `main` to `8.x`:
- [[Docs] Add breaking change to release notes
(#200065)](#200065)

<!--- Backport version: 9.4.3 -->

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

<!--BACKPORT
[{"author":{"name":"wajihaparvez","email":"[email protected]"},"sourceCommit":{"committedDate":"2024-11-14T17:02:01Z","message":"[Docs]
Add breaking change to release notes (#200065)\n\n##
Summary\r\n\r\nAdding a Kibana-related breaking change found in the
Security
release\r\nnotes.","sha":"20953fcb6f9476a5dfa89b581ee65a59c319a8f3","branchLabelMapping":{"^v9.0.0$":"main","^v8.17.0$":"8.x","^v(\\d+).(\\d+).\\d+$":"$1.$2"}},"sourcePullRequest":{"labels":["Team:Docs","release_note:skip","v9.0.0","v8.16.0","backport:version","v8.17.0"],"title":"[Docs]
Add breaking change to release
notes","number":200065,"url":"https://github.com/elastic/kibana/pull/200065","mergeCommit":{"message":"[Docs]
Add breaking change to release notes (#200065)\n\n##
Summary\r\n\r\nAdding a Kibana-related breaking change found in the
Security
release\r\nnotes.","sha":"20953fcb6f9476a5dfa89b581ee65a59c319a8f3"}},"sourceBranch":"main","suggestedTargetBranches":["8.16","8.x"],"targetPullRequestStates":[{"branch":"main","label":"v9.0.0","branchLabelMappingKey":"^v9.0.0$","isSourceBranch":true,"state":"MERGED","url":"https://github.com/elastic/kibana/pull/200065","number":200065,"mergeCommit":{"message":"[Docs]
Add breaking change to release notes (#200065)\n\n##
Summary\r\n\r\nAdding a Kibana-related breaking change found in the
Security
release\r\nnotes.","sha":"20953fcb6f9476a5dfa89b581ee65a59c319a8f3"}},{"branch":"8.16","label":"v8.16.0","branchLabelMappingKey":"^v(\\d+).(\\d+).\\d+$","isSourceBranch":false,"state":"NOT_CREATED"},{"branch":"8.x","label":"v8.17.0","branchLabelMappingKey":"^v8.17.0$","isSourceBranch":false,"state":"NOT_CREATED"}]}]
BACKPORT-->

Co-authored-by: wajihaparvez <[email protected]>

docs/CHANGELOG.asciidoc

@@ -156,9 +156,22 @@ The Observability AI Assistant specific advanced setting for Logs index patterns
 //*Impact* +
 //!!TODO!!
 ====
-
 
-
+[float]
+[[breaking-changes-8.16.0]]
+=== Breaking changes
+
+Breaking changes can prevent your application from optimal operation and performance.
+Before you upgrade to 8.16.0, review the breaking changes, then mitigate the impact to your application.
+
+[discrete]
+.Updated request processing during shutdown.
+[%collapsible]
+====
+*Details* +
+During shutdown, {kib} now waits for all the ongoing requests to complete according to the `server.shutdownTimeout` setting. During that period, the incoming socket is closed and any new incoming requests are rejected. Before this update, new incoming requests received a response with the status code 503 and body `{"message": "Kibana is shutting down and not accepting new incoming requests"}`. For more information, refer to {kibana-pull}180986[#180986].
+==== 
+
 [float]
 [[features-8.16.0]]
 === Features

docs/upgrade-notes.asciidoc

@@ -412,6 +412,15 @@ The endpoint is now split into two separate endpoints:
 
 // General settings
 
+[discrete]
+[[breaking-180986]]
+.[General settings] Updated request processing during shutdown. (8.16)
+[%collapsible]
+====
+*Details* +
+During shutdown, {kib} now waits for all the ongoing requests to complete according to the `server.shutdownTimeout` setting. During that period, the incoming socket is closed and any new incoming requests are rejected. Before this update, new incoming requests received a response with the status code 503 and body `{"message": "Kibana is shutting down and not accepting new incoming requests"}`. For more information, refer to {kibana-pull}180986[#180986].
+====
+
 [discrete]
 [[breaking-111535]]
 .[General settings] Removed `CONFIG_PATH` and `DATA_PATH` environment variables. (8.0)