diff --git a/docs/developer/plugin-list.asciidoc b/docs/developer/plugin-list.asciidoc
index df3f4c8ec855d..cb233fc8c10ce 100644
--- a/docs/developer/plugin-list.asciidoc
+++ b/docs/developer/plugin-list.asciidoc
@@ -672,7 +672,7 @@ Elastic.
 |This plugin allows for other plugins to add data to Kibana stack monitoring documents.
 
 
-|{kib-repo}blob/{branch}/x-pack/plugins/notifications/README.md[notifications]
+|{kib-repo}blob/{branch}/x-pack/plugins/notifications/README.mdx[notifications]
 |The Notifications plugin provides a set of services to help Solutions and plugins send notifications to users.
 
 
diff --git a/docs/setup/settings.asciidoc b/docs/setup/settings.asciidoc
index 9d38b5162f124..13e3fad93cfca 100644
--- a/docs/setup/settings.asciidoc
+++ b/docs/setup/settings.asciidoc
@@ -323,8 +323,7 @@ run {kib} in different modes. Valid options are `background_tasks` and `ui`,
 or `*` to select all roles. *Default: `*`*
 
 `notifications.connectors.default.email`::
-Specifies the name of the connector that is used to send email notifications.
-In {ecloud}, the default value is `elastic-cloud-email`.
+ Choose the default email connector for user notifications. As of `8.6.0`, {kib} is shipping with a new notification mechanism that will send email notifications for various user actions, e.g. assigning a _Case_ to a user. To enable notifications, an email connector must be <<pre-configured-connectors,preconfigured>> in the system via `kibana.yml`, and the notifications plugin must be configured to point to the ID of that connector.
 
 [[path-data]] `path.data`::
 The path where {kib} stores persistent data
diff --git a/nav-kibana-dev.docnav.json b/nav-kibana-dev.docnav.json
index c85c804cdfda4..56517c4136f7f 100644
--- a/nav-kibana-dev.docnav.json
+++ b/nav-kibana-dev.docnav.json
@@ -425,6 +425,9 @@
         {
           "id": "kibNewsfeedPluginApi"
         },
+        {
+          "id": "kibNotificationsPluginApi"
+        },
         {
           "id": "kibObservabilityPluginApi"
         },
diff --git a/x-pack/plugins/notifications/README.md b/x-pack/plugins/notifications/README.mdx
similarity index 100%
rename from x-pack/plugins/notifications/README.md
rename to x-pack/plugins/notifications/README.mdx