Skip to content

feat(docs): Apply new quick start template to JavaScript quick start guides - #19983

Merged
sfanahata merged 20 commits into
masterfrom
docs/quickstart-template-javascript
Oct 21, 2026
Merged

sfanahata merged 20 commits into
masterfrom
docs/quickstart-template-javascript

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 rest of the JavaScript quick starts:

  • Browser: plain JavaScript (/platforms/javascript/), React, Vue, Svelte, Solid, SolidStart, Gatsby, Capacitor, Electron, Wasm
  • Wizard-based: Next.js. The wizard flow stays, and the manual config shows every option.
  • Server and runtime: Azure Functions, Bun, Cloudflare, Deno, Effect, Elysia, Firebase, GCP Functions, Hono, NestJS, Nitro

Changes on each page:

  • Removes the onboarding option checkboxes and ___PRODUCT_OPTION___ markers.
  • Configure names every feature the SDK supports. The init snippet includes all of them by default, with a "The snippet also turns on" list and a note that unwanted options can be removed.
  • Adds Send Logs and Send Application Metrics as their own steps, with logging integrations (console, Consola, Pino, Winston) recommended only where they're documented for that SDK. Capacitor has no Metrics step because it doesn't support Application Metrics.
  • Keeps framework-specific setup (routing, error handlers, middleware, instrumentation, source maps, data collection) under Configure. Verify is reduced to one test error.
  • Removes "(Optional)" from headings. Tunneling moves to Next Steps for browser SDKs. Next Steps is trimmed.

Features are listed per SDK. Profiling appears only where the guide offered it, and Session Replay and User Feedback appear only on browser SDKs.

Plain JavaScript page: /platforms/javascript/ is rendered from platform-includes/getting-started-complete/javascript.mdx, which only that page uses. Its init snippet (npm, Loader and CDN tabs) and Verify snippet are written inline in that file, so the shared getting-started-config and getting-started-verify snippets other pages use are unchanged. The CDN tab now loads the full bundle (bundle.tracing.replay.feedback.logs.metrics.min.js), because the old tracing-only bundle doesn't include Session Replay or User Feedback. javascript.nextjs has been added to includes/quick-start-features-expandable.mdx and includes/quick-start-locate-data-expandable.mdx.

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 4 commits October 14, 2026 21:52
…id, and Gatsby

Co-Authored-By: Shannon Anahata <shannon.anahata@sentry.io>
…Electron, Wasm, Astro, and React Router

Co-Authored-By: Shannon Anahata <shannon.anahata@sentry.io>
…loudflare, Deno, Effect, and Elysia

Co-Authored-By: Shannon Anahata <shannon.anahata@sentry.io>
…, Hono, NestJS, and Nitro

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
sentry-docs Ready Ready Preview Oct 21, 2026 5:55pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Oct 21, 2026 5:55pm UTC

Request Review

@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Oct 14, 2026
@cursor

cursor Bot commented Oct 14, 2026 •

Copy link
Copy Markdown
Contributor

Rollout plan could not be created because the planning run failed.

Mention @change-monitor in a comment to try again.

…k start guide

Co-Authored-By: Shannon Anahata <shannon.anahata@sentry.io>
Co-Authored-By: Shannon Anahata <shannon.anahata@sentry.io>
sentry-junior Bot added a commit that referenced this pull request Oct 15, 2026
The quick start template PRs (#19980-#19983) still have to remove the
SplitLayout wrappers from 38 files. Until they merge, render those tags
as plain pass-throughs so the build and preview succeed. Remove this
shim once no MDX file uses the wrappers.

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>
…uides

The Bun and Deno runtime metrics integration pages only exist under the
Bun and Deno guides, so the platform-relative links 404 on Hono.
Shannon Anahata added 2 commits October 21, 2026 10:48
Remove the onboarding option checkboxes and include every supported
feature in the init snippets. Align the page with the wizard's current
output, add Send Logs and Send Application Metrics steps, and add
javascript.nextjs to the quick start feature expandables.

@sfanahata sfanahata left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All major frameworks built on the production Ember example. Reviewed thoroughly by Sarah and myself. Ready to merge.

@sfanahata
sfanahata merged commit 0d03193 into master Oct 21, 2026
27 checks passed
@sfanahata
sfanahata deleted the docs/quickstart-template-javascript branch October 21, 2026 18:30

This branch was successfully deployed

2 active (1 outdated) deployments
Preview – sentry-docs — 3ede1802 Deployed Oct 21, 2026 by vercel[bot]
Preview – develop-docs — cc7233ab 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.

2 participants