Skip to content

feat(docs): Apply new quick start template to Android quick start guide - #19986

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

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

Conversation

@sentry-junior

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

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Applies the quick start template from #19295 (Ember) to the Android quick start. The page keeps its single-column layout.

  • Removes the onboarding option checkboxes and ___PRODUCT_OPTION___ markers. Keeps the wizard install and the manual setup fallback.
  • Configure names the features the guide sets up (Error Monitoring, Tracing, Profiling, Session Replay, Logs, Application Metrics). The manifest snippet includes all options by default, and a note explains that unwanted options can be removed. User Feedback links to its setup page because it uses its own API, not an init option.
  • Logs need io.sentry.logs.enabled=true in the manifest, or options.logs.enabled = true (Kotlin) / options.getLogs().setEnabled(true) (Java) for code-based init. Application Metrics need no flag (SDK 8.34.0+).
  • Adds Send Logs (with Timber and Logcat integration links) and Send Application Metrics as their own steps, and simplifies Verify.

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 22:04
Co-Authored-By: Shannon Anahata <shannon.anahata@sentry.io>
Co-Authored-By: Shannon Anahata <shannon.anahata@sentry.io>
@vercel

vercel Bot commented Oct 15, 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 29, 2026 12:41am UTC
sentry-docs Ready Ready Preview Oct 29, 2026 12:41am UTC

Request Review

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

cursor Bot commented Oct 15, 2026 •

Copy link
Copy Markdown
Contributor

The plan checks pageload time, failed pageloads, and client errors on the Android quick start page. An issue escalates when client errors rise or pageloads fail above the baseline. The new page copy is not visible in telemetry.

Services: sentry-docs.

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

Plan

What changed

Requests to /platforms/android/ now render the new quick start template. The page no longer shows feature checkboxes. It always shows tracing, profiling, session replay, and logs setup. It adds Send Logs and Send Application Metrics sections. The Verify heading is now Verify Your Setup.

This change is live after sentry-docs deploys. The path is product docs content. Deploy config maps the Vercel project sentry-docs to that service.

Risk

A render failure on this page blocks Android SDK onboarding. New code tabs and the feature badge can throw on this page. The longer page can slow pageload. The old #verify hash no longer exists.

Intended effect

This rewrite emits no new counter. Telemetry cannot show the new headings or the missing checkboxes. Leave intended_effect unknown from telemetry. Absent would be the live page still showing feature checkboxes. Sentry cannot see that.

Regression watch

Watch the Android quick start path only. Client traces sample at 30 percent. Error events do not use that sample rate. Do not divide error counts by sampled spans. Current error titles are third-party fetch noise and sessionStorage access. Escalate when a new React or MDX title appears.

Pageload time may rise because the page is longer.

Signal Baseline Rule Source
Pageload and navigation p95 on /platforms/android/ 5308-6476 ms Hold in this band Sentry spans, org sentry, project docs. Query: span.op:[pageload,navigation] AND url.path:"/platforms/android/" AND environment:production. Fields count(), p95(span.duration). 24h window 2026-10-14T00:03:00Z to 2026-10-15T00:03:00Z: 60 spans, p95 6476 ms. 48h window 2026-10-13T00:03:00Z to 2026-10-15T00:03:00Z: 137 spans, p95 5308 ms.
Pageload and navigation volume on /platforms/android/ 60-77 sampled spans per 24h Hold in this band. A drop toward zero means the page is not served Same query as p95. 24h count 60. Prior 24h count 77 from 48h minus 24h.
Client error events on Android docs URLs 3-5 events per 24h Hold in this band. Escalate also when a new React or MDX title appears Sentry errors, org sentry, project docs. Query: environment:production AND (transaction:"*/platforms/android/*" OR url:"*/platforms/android/*"). 24h count 3. 48h count 8. Prior 24h count 5. 48h titles: Failed to fetch on insights.algolia.io (3), proxy.kapa.ai (2), plausible.io (1), and sessionStorage SecurityError (2).
Not-ok pageload share on /platforms/android/ 11-13 percent Hold in this band Sentry spans, org sentry, project docs. 48h not-ok pageload query: span.op:[pageload,navigation] url.path:"/platforms/android/" environment:production !span.status:ok gave 17 pageload spans versus 137 pageload and navigation spans, share 12 percent. 24h mixed span.op:[http.server,pageload] status query gave 3 error of 26 spans, share 12 percent. span.status error may include client faults, not only HTTP 5xx.

Not observable

The new headings and the removed checkboxes are not in Sentry. Hash hits to #verify are not measured. Plausible pageviews are not connected here.

This branch was successfully deployed

2 active deployments
Preview – sentry-docs — 84a19603 Deployed Oct 29, 2026 by vercel[bot]
Preview – develop-docs — 84a19603 Deployed Oct 29, 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