docs: Document notification customization via Long-Term Context

src/content/docs/docs/configuring-promptless/customizing-notifications.mdx

@@ -0,0 +1,70 @@
+---
+title: Customizing Notifications
+description: >-
+  Configure how Promptless notifies your team about documentation suggestions
+slug: docs/configuring-promptless/customizing-notifications
+sidebar:
+  hidden: false
+  order: 15
+---
+import Note from '@components/fern/Note.astro';
+import Tip from '@components/fern/Tip.astro';
+
+Promptless sends notifications to your team when documentation suggestions are ready for review. You can customize these notifications by editing a configuration file in your organization's Long-Term Context.
+
+## What is Long-Term Context?
+
+Long-Term Context (LTC) is where Promptless stores persistent configuration and preferences for your organization. It includes settings that influence how Promptless behaves across all documentation projects, including notification preferences.
+
+Your Promptless team can help you access and configure your Long-Term Context files. Contact us at [help@gopromptless.ai](mailto:help@gopromptless.ai) to get started.
+
+## Notification Configuration File
+
+Notification preferences are stored in the `doc_workflow/notification_skill.md` file within your Long-Term Context. When you first customize notifications, Promptless creates this file with sensible defaults.
+
+### What You Can Customize
+
+The notification configuration file lets you control:
+
+- **Notification defaults**: Set your preferred notification channels and timing
+- **Message templates**: Customize how suggestion summaries appear in notifications
+- **Tone and style**: Adjust the voice and formality of notification messages
+- **Delivery preferences**: Configure which events trigger notifications and how they're formatted
+
+### Example Customizations
+
+Here are some common ways teams customize their notifications:
+
+**Change the notification tone:**
+```
+Use a casual, friendly tone in all notification messages.
+Avoid formal language like "please be advised" or "for your review."
+```
+
+**Customize message content:**
+```
+Always include the number of files changed in the notification summary.
+Mention the trigger source (PR, Slack message, etc.) prominently.
+```
+
+**Set delivery preferences:**
+```
+Only send notifications for suggestions that modify more than one file.
+Include diff file attachments for all Slack notifications.
+```
+
+## Slack Notification Features
+
+When you have the [Slack integration](/docs/integrations/slack-integration) connected, Promptless sends rich notifications with:
+
+- **Interactive buttons**: Quickly publish suggestions or open PRs for review directly from Slack
+- **Diff file attachments**: See the full diff of documentation changes in a thread reply
+- **Channel support**: Receive notifications in specific channels by name, not just by ID
+
+<Tip>
+  Promptless automatically detects protected branches in your documentation repository. When detected, Slack notifications show "Create PR" or "View PR" buttons instead of "Publish" to prevent merge errors.
+</Tip>
+
+## Getting Help
+
+Need help configuring your notification preferences? Contact us at [help@gopromptless.ai](mailto:help@gopromptless.ai) and we'll help you set up the customizations that work best for your team.

src/lib/generated/sidebar.json

@@ -35,7 +35,7 @@
         "label": "Triggers",
         "items": [
           {
-            "label": "Overview",
+            "label": "Triggers",
             "slug": "docs/configuring-promptless/triggers"
           },
           {
@@ -97,6 +97,10 @@
             "slug": "docs/configuring-promptless/doc-collections/git-hub-repos-docs-as-code"
           }
         ]
+      },
+      {
+        "label": "Customizing Notifications",
+        "slug": "docs/configuring-promptless/customizing-notifications"
       }
     ]
   },