docs(alerts): move alert creation to its own page by souredoutlook · Pull Request #19067 · getsentry/sentry-docs

souredoutlook · 2026-08-15T04:27:28Z

Split the per-option detail out of the Alerts index into a dedicated Creating an Alert page, and document the new "alert on all issues in all projects" source option.

Add docs/product/monitors-and-alerts/alerts/create-alerts.mdx covering sources, environment, triggers, filters, actions, and throttling
Trim the Alerts index to a high-level summary plus permissions
Point legacy /product/alerts/create-alerts/ redirects at the new page
Update inbound links from the Monitors and uptime pages

DESCRIBE YOUR PR

Tell us what you're changing and why. If your PR resolves an issue, please link it so it closes automatically.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

Urgent deadline (GA date, etc.):
Other deadline:
None: Not urgent, can wait up to 1 week+

SLA

Teamwork makes the dream work, so please add a reviewer to your PRs.
Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

Checked Vercel preview for correctness, including links
PR was reviewed and approved by any necessary SMEs (subject matter experts)
PR was reviewed and approved by a member of the Sentry docs team

Split the per-option detail out of the Alerts index into a dedicated Creating an Alert page, and document the new "alert on all issues in all projects" source option. - Add docs/product/monitors-and-alerts/alerts/create-alerts.mdx covering sources, environment, triggers, filters, actions, and throttling - Trim the Alerts index to a high-level summary plus permissions - Point legacy /product/alerts/create-alerts/ redirects at the new page - Update inbound links from the Monitors and uptime pages Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

vercel · 2026-08-15T04:27:33Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated
develop-docs	Ready	Preview	Sep 23, 2026 8:27pm UTC
sentry-docs	Ready	Preview	Sep 23, 2026 8:27pm UTC

rodolfoBee

LGTM

sfanahata

I love the direction! I think we need to clean this up a bit before we merge. See comments and let me know if you want to chat.

Co-authored-by: Shannon Anahata <shannon.anahata@gmail.com>

- Fold the "Alert on All Projects" section into the source bullet and drop the now-dead anchor - Reword the If/Then filter explanation: one qualifier per If block, many blocks per Alert - Replace "occurrence-based monitors" jargon with the triggers the filters actually require - Move the filter-compatibility Alert up under If: Filters, where it applies to all filter types - Describe the ticket creation settings panel instead of an unexplained bolded phrase - Fix "sometvhing" typo Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Replaces the TODO placeholder in the Ticket Creation section. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

sfanahata

🚀 Looks great! Thanks for making the changes.

Covers two cases that are hard to self-diagnose today: integrations missing from the actions list, and hitting an Alert count limit. The limits are described rather than enumerated, since the specific ceilings aren't published and are raisable per organization. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

vercel Bot deployed to Preview – develop-docs August 15, 2026 04:29 View deployment

vercel Bot deployed to Preview – sentry-docs August 15, 2026 04:33 View deployment

souredoutlook requested a review from sfanahata August 15, 2026 13:48

rodolfoBee approved these changes Aug 18, 2026

View reviewed changes