docs(agent): add notification subscription settings to suggestions (#2430)

* docs(agent): add notification subscription settings to suggestions

Add documentation for email and Slack notification subscriptions for agent suggestions. Users can now configure notifications in the agent settings panel to receive alerts when new suggestions are created.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* copy edit

---------

Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: ethanpalm

ai/suggestions.mdx

@@ -18,41 +18,34 @@ Before using suggestions, you must install the [Mintlify GitHub App](/deploy/git
 
 ## Configure suggestions
 
-Configure which repositories the agent makes suggestions for in the agent settings.
+Configure which repositories the agent monitors and how you receive notifications in the agent settings. The settings page displays all the GitHub organizations and repositories the agent is monitoring.
 
-The configuration page displays all GitHub organizations where you've installed the Mintlify GitHub App and which repositories the agent is monitoring.
-
-### Select repositories to monitor
-
-After installing the Mintlify GitHub App on your organizations, select which repositories to monitor.
+To access the agent settings:
 
 1. Click the **Ask agent** button in your dashboard to open the agent panel.
 1. Click the **Settings** button.
     <Frame>
     <img src="/images/agent/dashboard-settings-light.png" alt="The settings button in light mode." className="block dark:hidden" />
     <img src="/images/agent/dashboard-settings-dark.png" alt="The settings button in dark mode." className="hidden dark:block" />
     </Frame>
-1. In the **Monitor Repositories** section, click the organization name that contains the repositories you want to monitor.
-1. Click the toggle on next to each repository you want to monitor, or click **Enable all** to monitor all repositories in the organization.
 
-The agent monitors the default branch (typically `main`) for each repository. A GitHub check named **Mintlify Autopilot** runs on pull requests in monitored repositories to analyze them for potential documentation updates. When you merge a pull request that requires documentation updates, the agent creates a suggestion in your dashboard.
+### Monitor repositories
+
+The agent monitors the default branch (typically `main`) for each repository that you enable. A GitHub check named **Mintlify Autopilot** runs on pull requests in monitored repositories to analyze them for potential documentation updates. When you merge a pull request that requires documentation updates, the agent creates a suggestion in your dashboard.
 
 <Note>
   When you first enable monitoring for a repository, the agent creates suggestions for pull requests merged in the last seven days. This backfill only occurs if no suggestions already exist for that repository. You may see multiple suggestions appear immediately after enabling monitoring.
 </Note>
 
-### Stop monitoring a repository
+If you disable monitoring, the agent immediately stops monitoring the repository. Any existing suggestions for that repository remain in your dashboard until you dismiss them.
 
-1. Click the **Ask agent** button in your dashboard to open the agent panel.
-1. Click the **Settings** button.
-    <Frame>
-    <img src="/images/agent/dashboard-settings-light.png" alt="The settings button in light mode." className="block dark:hidden" />
-    <img src="/images/agent/dashboard-settings-dark.png" alt="The settings button in dark mode." className="hidden dark:block" />
-    </Frame>
-1. In the **Monitor Repositories** section, click the organization name that contains the repositories you want to stop monitoring.
-1. Click the toggle off next to the repository you want to stop monitoring, or click **Disable all** to stop monitoring all repositories in the organization.
+### Notifications
+
+Agent suggestions always appear in your dashboard. You can configure notifications to receive email or Slack direct messages when the agent creates new suggestions.
 
-The agent immediately stops monitoring the repository. Any existing suggestions for that repository remain in your dashboard until you dismiss them.
+<Tip>
+  If you don't receive email notifications for suggestions, check your spam folder and add the email address `notifications@mintlify.com` to your safe sender list.
+</Tip>
 
 ## Review suggestions
 
@@ -78,6 +71,6 @@ Add suggestions as context for the agent to create pull requests.
 If a suggestion doesn't require documentation updates or you've already addressed the changes, dismiss it to remove it from your dashboard.
 
 1. Click the **Ask agent** button in your dashboard to open the agent panel.
-1. Click the **Dismiss** button next any suggestions that you want to dismiss.
+1. Click the **Dismiss** button next to any suggestions that you want to dismiss.
 
 The suggestion is immediately removed from your dashboard. You cannot retrieve dismissed suggestions.