Skip to content

chore: Update docs changelog - #20229

Open
getsantry[bot] wants to merge 1 commit into
masterfrom
bot/update-docs-changelog-20261026
Open

getsantry[bot] wants to merge 1 commit into
masterfrom
bot/update-docs-changelog-20261026

Conversation

@getsantry

@getsantry getsantry Bot commented Oct 26, 2026

Copy link
Copy Markdown
Contributor

Automated update of the docs changelog from recent merged PRs.

@vercel

vercel Bot commented Oct 26, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
sentry-docs Ready Ready Preview Oct 26, 2026 12:16am UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Oct 26, 2026 12:16am UTC

Request Review

@github-actions github-actions Bot added the Priority: Needs Triage The PR description is missing valid priority information label Oct 26, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Please update the IS YOUR CHANGE URGENT? section of the PR description:

  • Select exactly one option.
  • If you selected an urgent or other deadline, provide the date as YYYY-MM-DD.

This information helps the Docs team prioritize your review.

@cursor

cursor Bot commented Oct 26, 2026 •

Copy link
Copy Markdown
Contributor

The plan uses changelog page loads, changelog 404s, and client errors on changelog URLs. An issue escalates when those 404s appear or those errors rise. The new changelog entries have no metric.

Services: sentry-docs.

Mention @change-monitor in a comment to update the plan.

Plan

What changed

The /changelog/ page now lists merged documentation PRs through 23 October 2026. It previously listed entries through 18 September 2026. sentry-docs must deploy before this page is live. The Vercel production project sentry-docs ships docs/changelog.mdx. The developer-docs build excludes docs/** and does not ship this include. Runtime telemetry uses Sentry project docs.

Risk

A bad MDX include can render an empty changelog body. The Include component returns null for ENOENT and MDX_RUNTIME_ERROR. Users then see a 200 page with no entries. A compile failure during the production build can block the whole site deploy. The include grew by about 135 lines. Load time on /changelog/ may rise.

Intended effect

This change only rewrites documentation content. No metric shows the new 23 October entries. docs.page.load with page_type:changelog counts visits only. absent would be the same visit count while the page still shows 18 September entries. That page text is not queryable. Do not use visit count as confirmation.

Regression watch

Wrong MDX on this include can 404 /changelog/ or throw in the client renderer. A swallowed compile error leaves a blank 200 page. That blank page is not in this table.

Do not filter environment:production. Client init leaves environment unset outside development. Issue DOCS-9E9 is a sparse promise rejection on the catch-all route. Do not treat one such event as a regression.

Signal Baseline Window Rule Source
docs.page.load with page_type:changelog 5 loads per 24h. 43 loads in 7d. Mean about 6 loads per day. Band 3-9 loads per 24h. 2026-10-25T00:10:00Z to 2026-10-26T00:10:00Z. 7d: 2026-10-19T00:10:00Z to 2026-10-26T00:10:00Z Hold in 3-9 loads per 24h. A drop to 0 while other page_type values still load is a miss. Sentry org sentry project docs. metric.name:docs.page.load AND metric.type:counter AND page_type:changelog. Aggregate count(value).
Error events with url:*changelog* 1 event per 24h against 5 changelog loads. Rate 0.20. 3 events in 7d against 43 loads. Rate 0.07. Band 0-2 events per 24h. 2026-10-25T00:10:00Z to 2026-10-26T00:10:00Z. 7d: 2026-10-19T00:10:00Z to 2026-10-26T00:10:00Z Stay in 0-2 events per 24h. Rise above 2, or new MDX render titles, is a regression. Sentry org sentry project docs. Query url:*changelog*. Aggregate count().
docs.page.not_found with requested_path:*changelog* 0 events per 24h. 1 event in 7d. Band 0-1 events per 24h. 2026-10-25T00:10:00Z to 2026-10-26T00:10:00Z. 7d: 2026-10-19T00:10:00Z to 2026-10-26T00:10:00Z Hold in 0-1 events per 24h. A rise above 1 means /changelog/ is missing. Sentry org sentry project docs. metric.name:docs.page.not_found AND requested_path:*changelog*. Aggregate count(value).

Not observable

The rendered changelog text is not in telemetry. An empty body from a swallowed MDX_RUNTIME_ERROR also has no signal. Pageload LCP and INP on /changelog/ had no matching pageload or navigation spans in the 24h window at the 30% client trace sample. Server log line MDX file not found at runtime, returning 404 returned no rows in Sentry logs.

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — 681d2c51 Deployed Oct 26, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Needs Triage The PR description is missing valid priority information

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants