Skip to content

feat(docs): Apply new quick start template to Dart and Flutter quick start guides - #19981

Open
sentry-junior[bot] wants to merge 4 commits into
masterfrom
docs/quickstart-template-dart
Open

sentry-junior[bot] wants to merge 4 commits into
masterfrom
docs/quickstart-template-dart

Conversation

@sentry-junior

@sentry-junior sentry-junior Bot commented Oct 14, 2026

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Applies the quick start template from #19295 (Ember) to the Dart and Flutter quick starts.

  • Removes the onboarding option checkboxes and ___PRODUCT_OPTION___ markers.
  • Configure names the features each guide sets up: Error Monitoring, Logs, Application Metrics, and Tracing, plus Session Replay for Flutter. The init snippets include those options by default, and a note explains that unwanted options can be removed. Flutter's Configure step now shows the SentryFlutter.init the wizard creates, so the snippet is visible even when the wizard is used.
  • Adds Send Logs and Send Application Metrics as their own steps (Sentry.logger / Sentry.metrics, which need no enable flag in the current SDK). Send Logs links to the sentry_logging integration.
  • Simplifies Verify to a single test error. Flutter keeps the wizard's sample exception flow. Next Steps is trimmed.
  • flutter/manual-setup.mdx is unchanged. It's a separate manual flow and still uses the shared Dart logs/metrics verify includes.

IS YOUR CHANGE URGENT?

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: YYYY-MM-DD
  • No deadline: Not urgent, can wait up to 1 week+

PRE-MERGE CHECKLIST

  • 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

via shannon.anahata.

--

View Junior Session [Sentry]

sentry-junior Bot and others added 2 commits October 14, 2026 21:40
…start guides

Co-Authored-By: Shannon Anahata <shannon.anahata@sentry.io>
Co-Authored-By: Shannon Anahata <shannon.anahata@sentry.io>
@vercel

vercel Bot commented Oct 14, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
develop-docs Ready Ready Preview Oct 19, 2026 8:38pm UTC
sentry-docs Ready Ready Preview Oct 19, 2026 8:38pm UTC

Request Review

@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Oct 14, 2026
@codeowner-assignment
codeowner-assignment Bot requested a review from a team October 14, 2026 21:47
@cursor

cursor Bot commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

The plan checks page loads and client errors on the two quick start pages.
It also checks 404s for Dart paths.
An issue escalates when errors appear or those page loads fall to zero.

Services: sentry-docs.

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

Plan

What changed

The Dart quick start now always shows logs, metrics, and tracing setup.
It no longer shows product option checkboxes.
The Flutter quick start now always shows those steps plus Session Replay setup.
The init snippets turn those features on by default.
This copy is live after production deploys sentry-docs.

Risk

A render failure can take those two pages down for readers.
A client throw in the new layout can blank the page.
Sibling Dart and Flutter pages can 404 if generation fails.
In-product wizard copy that still expects option markers can drift from these pages.

Intended effect

This change is documentation copy.
Telemetry cannot show the new headings or snippets.
Confirmed means readers see Send Logs and Send Application Metrics without option checkboxes.
Absent means the old checkbox flow remains.
The executor cannot fill this axis from Sentry.

Regression watch

Watch the two edited pages and the rest of the Dart tree.
Weekday traffic on these pages may vary.
Treat a drop to zero page loads as the miss, not a small dip.

Signal Baseline Window Source Rule
Flutter quick start page loads 65-78 counts per 24h. 21.4-21.9% of Dart-tree loads 2026-10-12T21:48:22Z to 2026-10-14T21:48:22Z Sentry sentry/docs metric docs.page.load filter path:"/platforms/dart/guides/flutter/" Hold inside the band. Escalate if the count falls to 0.
Dart quick start page loads 3-6 counts per 24h. 1.0-1.6% of Dart-tree loads 2026-10-12T21:48:22Z to 2026-10-14T21:48:22Z Sentry sentry/docs metric docs.page.load filter path:"/platforms/dart/" Volume is low. Escalate if the count falls to 0.
Dart-tree page loads 297-365 counts per 24h 2026-10-12T21:48:22Z to 2026-10-14T21:48:22Z Sentry sentry/docs metric docs.page.load filter path:*platforms/dart* Hold inside the band. Escalate if the count falls far below the band.
Client errors on Dart URLs 0 errors per 24h 2026-10-13T21:48:22Z to 2026-10-14T21:48:22Z Sentry sentry/docs errors url:*platforms/dart* Hold at 0.
HTTP 5xx on Dart URLs 0 spans per 24h 2026-10-13T21:48:22Z to 2026-10-14T21:48:22Z Sentry sentry/docs traces http.server status 5xx and url containing platforms/dart Hold at 0.
Dart-path 404s 0 counts per 24h 2026-10-13T21:48:22Z to 2026-10-14T21:48:22Z Sentry sentry/docs metric docs.page.not_found filter requested_path:*dart* Hold at 0.

If the error count rises, inspect client exceptions on transaction /:path*? for SplitLayout or FeatureBadge throws.

Not observable

The new headings have no metric.
Client pageload duration cannot be sliced to these two URLs.
The client transaction name is /:path*?.
In-product wizard use of the removed option markers is not in this project.

…arts

Co-Authored-By: Shannon Anahata <shannon.anahata@sentry.io>
sfanahata added a commit that referenced this pull request Oct 19, 2026
…20017)

## DESCRIBE YOUR PR

Removes the `SplitLayout` component everywhere. Pages that used it now
render their text and code as regular docs content, with the standard
docs spacing.

- Removes the `<SplitLayout>`, `<SplitSection>`, `<SplitSectionText>`,
and `<SplitSectionCode>` wrapper lines from all 169 MDX files that used
them, including the quick start guides. Only the tag lines and the blank
lines around them change. Parsing each file before and after shows the
same content once the wrappers are ignored.
- Deletes `src/components/splitLayout/` and its registration in
`src/mdxComponents.ts`.
- Drops the SplitLayout guidance from
`.claude/skills/technical-docs/SKILL.md`.

Step numbering is unaffected. `StepConnector` finds its `h2` headings
with a descendant selector, so it doesn't depend on these wrappers.

This replaces #19984, which made SplitLayout render as a single column.

### Merge order

Merge this **first**. After it merges, the quick start template PRs that
also edit these files (#19980 Ruby, #19981 Dart and Flutter, #19982
Python, #19983 JavaScript) will need `master` merged in. Those conflicts
are limited to the removed wrapper tags.

## IS YOUR CHANGE URGENT?

- [ ] Urgent deadline (GA date, etc.): YYYY-MM-DD
- [ ] Other deadline: YYYY-MM-DD
- [x] No deadline: Not urgent, can wait up to 1 week+

## PRE-MERGE CHECKLIST

- [ ] 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](https://github.com/orgs/getsentry/teams/docs)

<!-- junior-request-attribution:start -->
via **shannon.anahata**.
<!-- junior-request-attribution:end -->

<!-- junior-session-footer:start -->
<!-- junior-conversation-id:slack%3AD0BB8KQT6MU%3A1792013336.218129 -->

--

[View Junior
Session](https://junior-prod.sentry.dev/conversations/slack%3AD0BB8KQT6MU%3A1792013336.218129)
[[Sentry]](https://sentry.sentry.io/explore/conversations/slack%3AD0BB8KQT6MU%3A1792013336.218129/?project=4510944073809921)

<!-- junior-session-footer:end -->

---------

Co-authored-by: sentry-junior[bot] <264270552+sentry-junior[bot]@users.noreply.github.com>
Co-authored-by: Shannon Anahata <shannon.anahata@sentry.io>
Resolve conflicts from #20017 (SplitLayout removal): keep this branch's
content without the removed wrapper tags, and keep master's other
changes to the same files.

Co-Authored-By: Shannon Anahata <shannon.anahata@sentry.io>

This branch was successfully deployed

2 active deployments
Preview – sentry-docs — 56977ed0 Deployed Oct 19, 2026 by vercel[bot]
Preview – develop-docs — 56977ed0 Deployed Oct 19, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Normal Docs review has no urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant