Skip to content

docs(dotnet): Update the 7.x migration guide for 7.0.0-rc.3 - #20349

Open
ric-oliv wants to merge 2 commits into
masterfrom
docs/dotnet-7-migration-guide-rc3
Open

ric-oliv wants to merge 2 commits into
masterfrom
docs/dotnet-7-migration-guide-rc3

Conversation

@ric-oliv

@ric-oliv ric-oliv commented Oct 30, 2026 •

Copy link
Copy Markdown
Member

DESCRIBE YOUR PR

Version 7.0.0-rc.3 of the Sentry SDK for .NET is out, so this PR updates the release candidate note at the top of the 7.x migration guide from #20143.

The note listed three things that work differently on 7.0.0-rc.2. All three fixes are in rc.3, so I removed the list:

The note no longer names a release candidate. It points at the latest one on NuGet instead, so another release candidate before GA won't need a docs PR.

I also fixed two gaps in the NU1605 paragraph:

  • Sentry.AspNetCore.Blazor.WebAssembly depends on the .NET 11 version of Microsoft.AspNetCore.Components.WebAssembly, so a Blazor WebAssembly app that pins 10.0.x fails to restore too. The paragraph now names that package.
  • An app that pins an older .NET 11 release candidate, such as 11.0.0-rc.2, fails the same way as one that pins 10.0.x. The paragraph now says "an older version" and that the error message shows the version to use.

I checked this against 7.0.0-rc.3 from nuget.org:

  • The default DecompressionMethods is GZip, Deflate.
  • A .NET 11 app fails to restore with NU1605 when it pins Microsoft.Extensions.Http 10.0.0 or 11.0.0-rc.2.
  • A Blazor WebAssembly app fails the same way when it pins Microsoft.AspNetCore.Components.WebAssembly 10.0.0.
  • All three fix PRs are in the 7.0.0-rc.3 tag.

No other page in the guide names a release candidate version. The whole alert still comes out at 7.0.0 GA.

Refs https://linear.app/getsentry/issue/NET-860
Refs getsentry/sentry-dotnet#5710

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

  • 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

Make sure you've checked the following before merging your changes:

  • 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

The release candidate note named 7.0.0-rc.2 and listed three things that
work differently there. 7.0.0-rc.3 has all three fixes, so the note now
names rc.3 and drops the list. The NU1605 paragraph stays, because rc.3's
net11.0 builds depend on the .NET 11 RC 3 versions of the same packages.

Refs NET-860

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 30, 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 30, 2026 12:32pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Preview Oct 30, 2026 12:32pm UTC

Request Review

@linear-code

linear-code Bot commented Oct 30, 2026

Copy link
Copy Markdown

NET-860

The release candidate note named a version, so every new release candidate
needed a docs PR. It now points at the latest release candidate on NuGet.

The NU1605 paragraph now also names Microsoft.AspNetCore.Components.WebAssembly,
which Sentry.AspNetCore.Blazor.WebAssembly depends on. It covers apps that pin
an older .NET 11 release candidate as well as 10.0.x, and says that the error
message shows the version to use.

Refs NET-860

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@ric-oliv
ric-oliv marked this pull request as ready for review October 30, 2026 14:30
@ric-oliv
ric-oliv requested review from a team October 30, 2026 14:53

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — 54eb3a10 Deployed Oct 30, 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