[v9] Encourage using inheritOrSampleWith for tracesSampler in js

[lforst]

DESCRIBE YOUR PR

Swaps over to documenting inheritOrSampleWith over parentSampled as migration guide for v9. Wasn't done with a versioned docs page because it was too annoying.

Resolves getsentry/sentry-javascript#15124

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

• Urgent deadline (GA date, etc.):
• Other deadline:
• None: Not urgent, can wait up to 1 week+

[vercel]

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name	Status	Preview	Comments	Updated (UTC)
sentry-docs	✅ Ready (Inspect)	Visit Preview	💬 Add feedback	Feb 3, 2025 5:42pm

2 Skipped Deployments

Name	Status	Preview	Comments	Updated (UTC)
changelog	⬜️ Ignored (Inspect)	Visit Preview		Feb 3, 2025 5:42pm
develop-docs	⬜️ Ignored (Inspect)	Visit Preview		Feb 3, 2025 5:42pm

[codecov]

Bundle Report

Changes will decrease total bundle size by 15 bytes (-0.0%) ⬇️. This is within the configured threshold ✅

Detailed changes

Bundle name	Size	Change
sentry-docs-server-cjs	10.7MB	-9 bytes (-0.0%) ⬇️
sentry-docs-client-array-push	9.38MB	-6 bytes (-0.0%) ⬇️

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	866.04kB	-0.0%
static/chunks/9557-*.js	-3 bytes	391.11kB	-0.0%
server/middleware-*.js	5.55kB	6.55kB	555.3% ⚠️
server/middleware-*.js	-5.55kB	1.0kB	-84.74%
static/dH05EoQJk5oA1gI63t21s/_buildManifest.js (New)	578 bytes	578 bytes	100.0% 🚀
static/dH05EoQJk5oA1gI63t21s/_ssgManifest.js (New)	77 bytes	77 bytes	100.0% 🚀
static/Ouo51kQm1b-*.js (Deleted)	-578 bytes	0 bytes	-100.0% 🗑️
static/Ouo51kQm1b-*.js (Deleted)	-77 bytes	0 bytes	-100.0% 🗑️

view changes for bundle: sentry-docs-server-cjs

Assets Changed:

Asset Name	Size Change	Total Size	Change (%)
1729.js	-3 bytes	1.63MB	-0.0%
../instrumentation.js	-3 bytes	965.23kB	-0.0%
9523.js	-3 bytes	941.45kB	-0.0%

[mydea]

Not directly related, but when we update this again, let's make sure to remove this line on this page too:

If a sampling decision is passed to startTransaction, that decision will be used, overriding everything else.

[lforst]

Not directly related, but when we update this again, let's make sure to remove this line on this page too:

If a sampling decision is passed to startTransaction, that decision will be used, overriding everything else.

I think we can update this already now

[coolguyzone]

LGTM!