Skip to content

Conversation

ryan953
Copy link
Member

@ryan953 ryan953 commented Aug 25, 2025

Inside /product/explore/session-replay/ i noticed we had sort of two paths for users to follow: web or mobile. There was a lot of the same information in each side, but they were not structured in the same way.

So i tried to merge things together where it makes sense, and keep the web vs. mobile split for as few things as possible.

The big change is that mobile doesn't have it's own ## Replay Details section anymore. And replay-details.mdx is less web-specific.

Now we have:

  • unified Replays Page and Filters docs
  • unified Replays Details docs
  • high-level Replay for Web page with "What is Replay", "Supported SDKs", "Backend Errors" sections, performance sub-page
  • high-level Replay for Mobile page with "What is Replay", "Supported SDKs", "Backend Errors" sections (also FAQ), performance sub-page
SCR-20250825-njmd SCR-20250825-njmz

Copy link

vercel bot commented Aug 25, 2025

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

Project Deployment Preview Comments Updated (UTC)
sentry-docs Ready Ready Preview Comment Aug 28, 2025 7:57pm
1 Skipped Deployment
Project Deployment Preview Comments Updated (UTC)
develop-docs Ignored Ignored Preview Aug 28, 2025 7:57pm

@codeowner-assignment codeowner-assignment bot requested review from jas-kas and a team August 25, 2025 22:07
Copy link

codecov bot commented Aug 25, 2025

Bundle Report

Changes will increase total bundle size by 14.11kB (0.06%) ⬆️. This is within the configured threshold ✅

Detailed changes
Bundle name Size Change
sentry-docs-edge-server-array-push 352.31kB 574 bytes (0.16%) ⬆️
sentry-docs-client-array-push 9.9MB -6 bytes (-0.0%) ⬇️
sentry-docs-server-cjs 12.49MB 13.54kB (0.11%) ⬆️

Affected Assets, Files, and Routes:

view changes for bundle: sentry-docs-client-array-push

Assets Changed:

Asset Name Size Change Total Size Change (%)
static/chunks/pages/_app-*.js -3 bytes 882.71kB -0.0%
static/chunks/8321-*.js -3 bytes 425.87kB -0.0%
server/middleware-*.js 5.55kB 6.55kB 555.3% ⚠️
server/middleware-*.js -5.55kB 1.0kB -84.74%
static/_bLKvdI72r4lCR6Qx7kdh/_buildManifest.js (New) 684 bytes 684 bytes 100.0% 🚀
static/_bLKvdI72r4lCR6Qx7kdh/_ssgManifest.js (New) 77 bytes 77 bytes 100.0% 🚀
static/Tw_2ieufCECO-*.js (Deleted) -684 bytes 0 bytes -100.0% 🗑️
static/Tw_2ieufCECO-*.js (Deleted) -77 bytes 0 bytes -100.0% 🗑️
view changes for bundle: sentry-docs-edge-server-array-push

Assets Changed:

Asset Name Size Change Total Size Change (%)
src/middleware.js 574 bytes 207.59kB 0.28%
view changes for bundle: sentry-docs-server-cjs

Assets Changed:

Asset Name Size Change Total Size Change (%)
1729.js -3 bytes 1.78MB -0.0%
../instrumentation.js -3 bytes 1.1MB -0.0%
9523.js -3 bytes 1.08MB -0.0%
../app/[[...path]]/page.js.nft.json 4.52kB 768.5kB 0.59%
../app/platform-redirect/page.js.nft.json 4.52kB 768.42kB 0.59%
../app/sitemap.xml/route.js.nft.json 4.52kB 765.89kB 0.59%

Copy link
Member Author

Choose a reason for hiding this comment

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

Copy link
Member

@jas-kas jas-kas left a comment

Choose a reason for hiding this comment

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

thank you for addressing one of my biggest gripes with the session replay docs!!!!

there's work to do on consistent formatting imo, but this is great <3

@@ -11,22 +11,22 @@ You can search for or browse replays of user sessions on the **Replay** page, wh
- **Project**: The project in which the session was recorded.
- **Start Time**: How long ago the replay was triggered. (Replays can appear here while the recording is still in progress.)
- **Duration**: The length of the replay. (Recordings can range from 1 second to 60 minutes.)
- **Errors:** The number of frontend errors identified by Sentry, as encountered in the replay. (Sometimes the error count reported is different from the actual errors captured. Read more in [Error Linking](/platforms/javascript/session-replay/#error-linking).)
- **Errors:** The number of frontend errors identified by Sentry, as encountered in the replay. (Sometimes the error count reported is different from the actual errors captured. Read more in [Error Linking](/platform-redirect/?next=/session-replay/#error-linking).)
Copy link
Member

Choose a reason for hiding this comment

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

This link takes me to an odd view in the Vercel preview... I see a shortlist of SDKs (not even comprehensive to everything Replay covers) and then then that goes to a generic Replay docs page?

What is the Error Linking link supposed to be? 🤔

Copy link
Member

Choose a reason for hiding this comment

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

Ah it's a special platform re-direct, I'm assuming the missing platforms don't have the relevant section in their own docs, so that's OK.

Clicking on a platform link in the list, doesn't take me to Error Linking tho :(

Copy link
Member Author

@ryan953 ryan953 Aug 26, 2025

Choose a reason for hiding this comment

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

i'll look at making this link respect the #error-linking but that'll be in another PR because the link is more of a core-component.

- **User Inputs:** except password fields which are always redacted.
- **Navigations, Page Loads & View Changes:** [Learn more about spans](/product/sentry-basics/distributed-tracing/)
- **Mobile specific:** Backgrounding and Foregrounding, Network connectivity and battery usage
- **Web Vitals:** With links to [Web Vitals Insights](/product/insights/web-vitals/)
Copy link
Member

Choose a reason for hiding this comment

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

Can we list out the vitals instead? and web vitals URL could be behind a "Learn more."

Copy link
Member Author

Choose a reason for hiding this comment

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

Updated to be:

  • Web Vitals: and an overall Performance Score Learn more

Co-authored-by: Jasmin <77064737+jas-kas@users.noreply.github.com>
Co-authored-by: Michelle Zhang <56095982+michellewzhang@users.noreply.github.com>
@codeowner-assignment codeowner-assignment bot requested review from jas-kas and a team August 27, 2025 22:29
@codeowner-assignment codeowner-assignment bot requested review from a team August 28, 2025 15:46
Co-authored-by: Michelle Zhang <56095982+michellewzhang@users.noreply.github.com>
@ryan953 ryan953 enabled auto-merge (squash) August 28, 2025 19:41
@codeowner-assignment codeowner-assignment bot requested a review from a team August 28, 2025 19:41
@ryan953 ryan953 merged commit d294133 into master Aug 28, 2025
15 checks passed
@ryan953 ryan953 deleted the ryan953/replay-walkthrough-ref branch August 28, 2025 19:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants