add docs for notifications

docs/config.json

@@ -9,8 +9,8 @@
           "slug": "/"
         },
         {
-           "title": "Get Started",
-           "slug": "/get-started/"
+          "title": "Get Started",
+          "slug": "/get-started/"
         },
         {
           "title": "Core Concepts",
@@ -35,7 +35,7 @@
             {
               "title": "Upgrading Reference",
               "slug": "/upgrading/upgrading-reference/"
-	        },
+            },
             {
               "title": "Client Tool Automatic Updates",
               "slug": "/upgrading/client-tools-autoupdate/"
@@ -49,27 +49,30 @@
         {
           "title": "Usage Reporting and Billing",
           "slug": "/usage-billing/",
-          "forScopes": ["cloud", "enterprise"]
+          "forScopes": [
+            "cloud",
+            "enterprise"
+          ]
         },
         {
           "title": "Upcoming Releases",
           "slug": "/upcoming-releases/"
         },
-	{
-	  "title": "Cloud IP Addresses",
-	  "slug": "/ips/"
-	},
+        {
+          "title": "Cloud IP Addresses",
+          "slug": "/ips/"
+        },
         {
           "title": "Changelog",
           "slug": "/changelog/"
         }
       ]
     },
     {
-    	"icon": "wrench",
-    	"title": "Admin Guides",
-    	"entries": [],
-    	"generateFrom": "admin-guides"
+      "icon": "wrench",
+      "title": "Admin Guides",
+      "entries": [],
+      "generateFrom": "admin-guides"
     },
     {
       "icon": "connect",
@@ -102,6 +105,10 @@
         {
           "title": "Database GUI Clients",
           "slug": "/connect-your-client/gui-clients/"
+        },
+        {
+          "title": "Notifications",
+          "slug": "/connect-your-client/notifications/"
         }
       ]
     },
@@ -292,15 +299,14 @@
     {
       "source": "/enroll-resources/workload-identity/workload-attestation/",
       "destination": "/reference/workload-identity/workload-identity-api-and-workload-attestation/",
-       "permanent": true
+      "permanent": true
     },
     {
       "source": "/access-controls/guides/role-templates/",
       "destination": "/admin-guides/access-controls/guides/role-templates/",
       "permanent": true
     },
     {
-
       "source": "/enterprise/sso/",
       "destination": "/admin-guides/access-controls/sso/",
       "permanent": true
@@ -371,4 +377,4 @@
       "permanent": true
     }
   ]
-}
+}

docs/pages/connect-your-client/notifications.mdx

@@ -0,0 +1,50 @@
+---
+title: Notifications
+description: Provides a detailed breakdown of Teleport's notification system.
+---
+
+Teleport's notification system allows users to be notified of various events, updates, and warnings in real time.
+
+This guide explains how to interact with notifications in the Web UI and how cluster administrators can create custom notifications for their users.
+
+## Interacting with notifications in the Web UI
+
+In the Web UI, you can list all your notifications by clicking on the bell icon in the top right of the navigation bar.
+
+Clicking on a notification will redirect you to the relevant page, or in the case of a custom notification generated by an administrator, open a dialog containing its text content.
+You can mark the notification as read to acknowledge it, or hide it to have it never be shown to you again.
+
+Some notifications may include quick action buttons which allow you perform actions directly from the notification, such as assuming granted roles from an approved access request notification.
+
+![Notification in the WebUI](../../img/notification.png)
+
+## Creating and managing notifications
+
+Cluster administrators with `create` permissions for the `notification` resource can create and manage custom notifications using the `tctl notifications` command. These notifications
+contain custom text content and can be configured to target either all users, a specific user, or users with certain roles.
+
+Please note that custom notifications are stored in the backend in plaintext, and should therefore not include any sensitive information or be used for security-critical purposes.
+
+### Examples
+
+```code
+# Create a notification for a specific user.
+# Only user alice will see this notification.
+$ tctl notifications create --user=alice --title="Upcoming Database Maintenance" \
+  --content="We will be conducting a database upgrade tomorrow at 2AM UTC"
+
+# Create a notification for users with the `engineer` role that expires in 2 days
+$ tctl notifications create --roles=engineer --title="Reminder" \
+  --content="Please use access requests to request access to production servers" --ttl=2d
+
+# List notifications.
+$ tctl notifications ls
+ID                                   Created             Expires             Title                Labels
+------------------------------------ ------------------- ------------------- -------------------- ------
+0194d8b2-5a38-7858-88fe-5fcee3ff1ceb 06 Feb 25 00:39 UTC 08 Mar 25 00:39 UTC Example notification
+
+# Delete a notification.
+$ tctl notifications rm 3b8eb3d6-da9a-5353-aece-cbc885ecbf73
+```
+
+For more detailed information on this family of commands, please refer to the [CLI Reference](../reference/cli/tctl.mdx#tctl-notifications-create).