[sfanahata]

Follow-up to #19990: correct setup and verification across the base .NET quick start and all 19 integration guides, checked against SDK 6.12.1.

Most setup inaccuracies predate the template migration. This also corrects the new claim that Sentry.Profiling installs on .NET Framework and adds the tracing option missing from the WinForms VB examples.

• Fix package prerequisites, missing imports and terminators, ASP.NET Core and MAUI compatibility guidance, EF6 application-lifetime disposal, and the Google Cloud Functions user-factory interface.
• Separate AppKit/macOS initialization from iOS and Mac Catalyst, scope Cocoa features to supported targets, and explicitly enable native tracing on Apple and Android.
• Use the OTLP exporter and OpenTelemetry sampling for the Blazor Server example; remove duplicate logging registration from Blazor WebAssembly.
• Clarify which integration initializes Sentry, enable structured logs where needed, and verify logging through the configured provider or appender.
• Add shared verification steps for logs, metrics, and traces, including manual transactions where sampling alone doesn't create tracing data.

Validation: 31 focused documentation tests and all applicable pre-commit checks passed, including typo, external-link, and trailing-slash checks. All 22 changed MDX files compiled through the repository pipeline with website telemetry disabled in the temporary validation harness; shared includes, JSON examples, and the new OTLP link resolved. The .NET SDK is unavailable locally, so C#/VB snippets were source-checked but not compiled or run.

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+

[vercel]

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

Project	Deployment	Actions	Updated
sentry-docs	Ready	Preview	Oct 29, 2026 6:40pm UTC

1 Skipped Deployment

Project	Deployment	Actions	Updated
develop-docs	Ignored	Preview	Oct 29, 2026 6:40pm UTC

[sfanahata]

cc @ric-oliv — this follows up on #19990 with corrections to the .NET quick-start setup and verification instructions.

[ric-oliv]

Thank you, @sfanahata!

It looks great in general, I'm just adding a few comments.

The changes that matter most for readers are removing native tracing from the Android and Apple quick starts, the VB snippets that still don't compile, and the Blazor WASM sample rate.

Many lines in these examples set options to their default values (for example options.Native.AnrEnabled = true on Android). Either way works from the SDK side: keeping them shows readers which options exist, and removing them makes the snippets shorter. If you'd rather remove them, let me know and I'll mark the lines.

[cursor]

The plan checks page loads on the changed guides, 404s on that path, and MDX runtime warnings.
An issue escalates when those pages stop loading or 404s rise.
The new guide text itself cannot be checked from telemetry.

Services: sentry-docs.

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

Plan

What changed

Readers of the .NET getting-started pages now see corrected setup and verification steps.
The guides fix package names, init snippets, and tracing options for SDK 6.12.1.
Shared includes now tell readers how to verify logs, metrics, and traces.
sentry-docs must deploy before this change is live.

The changed routes are:

• /platforms/dotnet/
• /platforms/dotnet/guides/android/
• /platforms/dotnet/guides/apple/
• /platforms/dotnet/guides/aspnet/
• /platforms/dotnet/guides/aspnetcore/
• /platforms/dotnet/guides/aws-lambda/
• /platforms/dotnet/guides/azure-functions-worker/
• /platforms/dotnet/guides/blazor-server/
• /platforms/dotnet/guides/blazor-webassembly/
• /platforms/dotnet/guides/entityframework/
• /platforms/dotnet/guides/extensions-logging/
• /platforms/dotnet/guides/google-cloud-functions/
• /platforms/dotnet/guides/log4net/
• /platforms/dotnet/guides/maui/
• /platforms/dotnet/guides/nlog/
• /platforms/dotnet/guides/serilog/
• /platforms/dotnet/guides/winforms/
• /platforms/dotnet/guides/winui/
• /platforms/dotnet/guides/wpf/
• /platforms/dotnet/guides/xamarin/

Risk

A broken MDX include can hide the new verification text.
A compile or routing failure can 404 a changed guide.
New code blocks can break the code-tab UI on those pages.
Wrong init advice can send readers to a broken SDK setup.
That last failure is not visible in site telemetry.

Intended effect

The new wording is not queryable from telemetry.
A page load only shows that the route still renders.
Do not treat a load as proof the new text is live.
Absent and confirmed look the same in metrics.
Record intended effect as unknown.

Regression watch

If this change is wrong, the changed guides fail to render or return 404.
Query Sentry org sentry, project docs.

For page loads use docs.page.load with path in the 20 routes above.
For 404s use docs.page.not_found with requested_path:*platforms/dotnet*.
Pair that 404 count with docs.page.load where path:"*/platforms/dotnet*".
For MDX faults use logs matching message:"*MDX file not found at runtime*".
If 404s rise, inspect those MDX logs for the missing path.

The page-load band comes from 90 loads in the prior 24h and 122 loads in the last 24h.
A 7d sample was 656 loads, or 3.9 per hour.
The 404 share uses 1 not-found event against 784 /platforms/dotnet page loads.
A matching 48h sample had 2 not-found events.

Signal	Baseline	Window	Source	Rule
docs.page.load on the 20 changed routes	3.7-5.1 loads per hour	2026-10-25T20:00:00Z to 2026-10-27T20:00:00Z	Sentry metrics, project docs	Hold in this band. A fall below 3.7 per hour is a regression.
docs.page.not_found for requested_path platforms/dotnet	0.00-0.13% of /platforms/dotnet page loads	2026-10-26T20:00:00Z to 2026-10-27T20:00:00Z	Sentry metrics, project docs	Hold in this band. A rise above 0.3% is a regression.
MDX file not found at runtime logs	0 events	2026-10-26T20:00:00Z to 2026-10-27T20:00:00Z	Sentry logs, project docs	Hold at 0. Any rise is a regression.

Not observable

Wording correctness of the new C# and VB snippets.
Silent empty PlatformContent includes when the include path does not match.
Client errors on these 20 URLs. Pageload transactions use a catch-all name and do not slice these URLs.
A request.url error search on these routes returned zero events.
Pre-ship load rate for apple, blazor-server, google-cloud-functions, and xamarin.
Those four routes had zero loads in 2026-10-26T20:00:00Z to 2026-10-27T20:00:00Z.
A drop on those four routes is not detectable.

Get Slack DMs about this change: cursor.com/automations/rollouts

[coolguyzone]

Suggested change

	If another integration already initializes Sentry, add the NLog target without reinitializing the SDK. Enable `EnableLogs` on the options used by that integration to send structured logs.
	If another integration already initializes Sentry, add the NLog target without reinitializing the SDK. Set `EnableLogs = true` on the options used by that integration to send structured logs.

[coolguyzone]

Looks good to me!