Draft improvements from assistant conversations: explain notification tabs

async-collaboration/notifications/customize-behavior.mdx

@@ -1,11 +1,23 @@
 ---
-title : "Customize Behavior"
+title: "Customize notifications behavior"
+description: "Configure notification tabs, unread counts, read-state visibility, delay and batching, and cross-organization For You feeds for the Notifications Panel."
 ---
 
 # Configuration
 #### setTabConfig
 - Using this config, you can customize the name of the tabs or disable them altogether.
-- By default, all the three tabs are enabled.
+- By default, the `forYou`, `documents`, and `all` tabs are enabled.
+
+The Notifications Panel supports up to four tabs. Each tab shows a different slice of the same notification data:
+
+| Tab         | What it shows                                                                                                                                                                          |
+| ----------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `forYou`    | Notifications directed at the current user — mentions, replies to their comments, assignments, and any notification where they are an explicit recipient. Latest 50 items by default. |
+| `people`    | Notifications grouped by the user who triggered them. Useful for scanning activity by teammate.                                                                                        |
+| `documents` | Notifications grouped by document. Shows up to 15 notifications for each of the 15 most recently active documents the user can access.                                                 |
+| `all`       | Every notification across all documents the user has access to, ungrouped.                                                                                                             |
+
+The underlying notification data is the same across tabs — only the filter and grouping differ. Set `enable: false` on any tab in `tabConfig` to hide it, or change `name` to override the visible label.
 
 <Tabs>
 <Tab title="React / Next.js with Hooks">

async-collaboration/notifications/overview.mdx

@@ -1,6 +1,7 @@
 ---
 title: "In-app Notifications"
 sidebarTitle: "Overview"
+description: "Show in-app notifications for Velt comments, mentions, replies, and custom events across the For You, People, Documents, and All tabs."
 ---
 
 By default, the in-app notifications component is connected to Velt's Comments feature. All relevant comment notifications automatically show up here.
@@ -9,6 +10,17 @@ You can also add custom notifications from your app into Velt's notifications fe
 
 In-app notifications are only generated and fetched for documents the user has access to.
 
+## Tabs
+
+The Notifications Panel organizes the same notification data into up to four tabs:
+
+- **For You**: Notifications directed at the current user — mentions, replies to their comments, assignments, and any notification where they are an explicit recipient.
+- **People**: Notifications grouped by the user who triggered them.
+- **Documents**: Notifications grouped by document, across the documents the current user can access.
+- **All**: Every notification across all accessible documents, ungrouped.
+
+You can rename or hide any tab with [`setTabConfig`](/async-collaboration/notifications/customize-behavior#settabconfig).
+
 ## Default Configuration
 
 **Max count:**