Skip to content

docs(dotnet): Add supported versions to the MAUI guide for SDK 7.0.0 - #20642

Merged
jamescrosswell merged 1 commit into
dotnet-v7from
dotnet-v7-maui-supported-versions
Nov 10, 2026
Merged

jamescrosswell merged 1 commit into
dotnet-v7from
dotnet-v7-maui-supported-versions

Conversation

@ric-oliv

@ric-oliv ric-oliv commented Nov 9, 2026

Copy link
Copy Markdown
Member

Note

This targets dotnet-v7, which collects the .NET docs for sentry-dotnet 7.0.0. #20641 merges that branch into master when 7.0.0 ships, so this PR can merge into dotnet-v7 as soon as it's approved.

DESCRIBE YOUR PR

The MAUI guide doesn't say which .NET and OS versions Sentry.Maui supports, and it still lists Tizen, which the SDK dropped in 4.0. This adds a Supported Versions section for 7.x and removes Tizen from the feature list. The docs aren't versioned, so the section is written for 7.x, with a "Changed in Version 7.0.0" note that sends 6.x readers to the migration guide.

The new section lists:

  • .NET 10 and .NET 11
  • the minimum Android API level and the minimum iOS, Mac Catalyst and Windows versions for each
  • the Xcode version, which the .NET iOS and Mac Catalyst workloads set. It links to the dotnet/macios releases, which name it for each release.

Closes getsentry/sentry-dotnet#5714

Notes for review

  • The values come from Directory.Build.props on version7 (51e7d99f). They match the SupportedOSPlatform attributes in the 7.0.0-rc.2 Sentry.Maui assemblies, and the platform table in the migration guide's "Supported .NET Versions and Platforms" section, which has no Windows row.
  • James asked on the issue to ship this with the 7.0 docs, so the page only shows the 7.x values.
  • The 6.x note names only the .NET versions. The iOS minimum changed during 6.x, from 13.0 in 6.0.0 to 15.0 by 6.5.0, so one set of 6.x minimums would be wrong for part of 6.x.
  • The page doesn't pin an Xcode version. The Sentry packages don't check it, and the required Xcode changes between workload releases for the same .NET version. .NET 10 has workload releases for both Xcode 27.0 and 27.1, for example.
  • docs(dotnet): Correct quick-start setup and verification #20240 adds a line under the intro saying Sentry.Maui 6.x needs .NET MAUI 9 or later. Once it's on master and merged into dotnet-v7, that line should go, since this section covers it.
  • The issue mentions that the .NET guides for Apple and Android have the same gap. This PR only covers the MAUI guide, which is what the issue scopes.

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.): 2026-11-30
  • Other deadline: YYYY-MM-DD
  • No deadline: Not urgent, can wait up to 1 week+

The MAUI guide didn't say which .NET and OS versions Sentry.Maui
supports, and it still listed Tizen, which the SDK dropped in 4.0.

Add a Supported Versions section with the 7.x values from
Directory.Build.props on version7: .NET 10 and 11, and the minimum
Android, iOS, Mac Catalyst and Windows versions for each. The .NET
workloads set the Xcode version, so the page links to their release
notes instead of naming one. A "Changed in Version 7.0.0" note sends
6.x readers to the migration guide.

Closes getsentry/sentry-dotnet#5714

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

vercel Bot commented Nov 9, 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 Nov 9, 2026 2:01pm UTC
1 Skipped Deployment
Project Deployment Actions Updated
develop-docs Ignored Ignored Nov 9, 2026 2:01pm UTC

Request Review

@github-actions github-actions Bot added the Priority: Urgent Docs review is needed immediately for an urgent deadline label Nov 9, 2026
@codeowner-assignment
codeowner-assignment Bot requested a review from a team November 9, 2026 13:54
@ric-oliv ric-oliv mentioned this pull request Nov 9, 2026
6 of 8 tasks
@ric-oliv
ric-oliv marked this pull request as ready for review November 9, 2026 14:01
@codeowner-assignment
codeowner-assignment Bot requested a review from a team November 9, 2026 14:01
@cursor

cursor Bot commented Nov 9, 2026

Copy link
Copy Markdown
Contributor

Getting ready to monitor this change · Rollout details

Status Service Environment
⏳ Getting ready to monitor this change

@jamescrosswell
jamescrosswell merged commit a4c78b0 into dotnet-v7 Nov 10, 2026
12 checks passed
@jamescrosswell
jamescrosswell deleted the dotnet-v7-maui-supported-versions branch November 10, 2026 02:42
ric-oliv added a commit that referenced this pull request Nov 13, 2026
## DESCRIBE YOUR PR

This gets the 6.x to 7.x migration guide for the Sentry SDK for .NET
ready for 7.0.0, following #20143. It targets `dotnet-v7`, so it goes
live with the rest of the 7.0.0 docs in #20641.

- Removes the release candidate alert. Its note about restore error
NU1605 still applies to .NET 11 apps on 7.0.0, so it moves to "Supported
.NET Versions and Platforms".
- Adds "Category Log Levels No Longer Filter Breadcrumbs and Events",
for getsentry/sentry-dotnet#5869. Entries under
`Logging:Sentry:LogLevel` now only filter logs, so an app that silenced
a category gets that category's breadcrumbs and events. The section
shows `AddLogEntryFilter` for apps that want the old filtering.
- Adds `GetInternalSentryOptions` to "Other Removed and Internal APIs",
for getsentry/sentry-dotnet#5862, and points to the new
`GetDiagnosticLogger()` extension on `IHub`.
- Links the Generic Host guide from #20311 and the MAUI guide's
supported versions from #20642, which are both on `dotnet-v7`.

These two SDK PRs are the only changes merged on `version7` since
7.0.0-rc.3 that affect people upgrading from 6.x.

Two things depend on how 7.0.0 ships:

- The NU1605 note assumes the `net11.0` builds depend on the stable .NET
11 packages. On `version7` today, they depend on .NET 11 RC 3.
- The `LogLevel` fix also landed on 6.x in getsentry/sentry-dotnet#5872,
which isn't released yet. The section says "6.12.1 and earlier", so it
stays correct whether or not a 6.x release ships first.

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.

- [x] Urgent deadline (GA date, etc.): 2026-10-10
- [ ] Other deadline: YYYY-MM-DD
- [ ] No deadline: Not urgent, can wait up to 1 week+

## SLA

- Teamwork makes the dream work, so please add a reviewer to your PRs.
- Please give the docs team up to 1 week to review your PR unless you've
supplied a deadline.

Thanks in advance for your help!

## 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](https://github.com/orgs/getsentry/teams/docs)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: James Crosswell <jamescrosswell@users.noreply.github.com>
Co-authored-by: Alex Krawiec <alex.krawiec@sentry.io>
ric-oliv added a commit that referenced this pull request Nov 15, 2026
## DESCRIBE YOUR PR

This updates the .NET docs for sentry-dotnet 7.0.0, which has been on
NuGet since 2026-11-12. Each change was reviewed in its own PR against
the `dotnet-v7` branch, so the 7.x docs go live together:

- #20311 docs(dotnet): Add a Generic Host guide for SDK 7.0.0
- #20642 docs(dotnet): Add supported versions to the MAUI guide for SDK
7.0.0
- #19960 docs(dotnet): Document release and environment resolution for
SDK 7.0.0
- #19961 docs(dotnet): Update Microsoft.Extensions.Logging guide for SDK
7.0.0
- #19924 docs(dotnet): Update OTLP propagation docs for SDK 7.0.0
- #19925 docs(dotnet): Update logging docs for SDK 7.0.0
- #20715 docs(dotnet): Document ClearProviders() in the ASP.NET Core
guide for SDK 7.0.0
- #20752 docs(dotnet): Tell .NET Framework apps to install
Microsoft.Extensions.Logging for SDK 7.0.0
- #20743 docs(dotnet): Document NLog's MinimumLogLevel for SDK 7.0.0
- #20742 docs(dotnet): Link the Generic Host guide from the other .NET
pages for SDK 7.0.0
- #20689 docs(dotnet): Update the 7.x migration guide for 7.0.0
- #20780 docs(dotnet): Fix Serilog flushing, Serilog usings and the
Azure Functions package for SDK 7.0.0
- #20781 docs(dotnet): Fix the .NET logs and metrics examples and other
pages for SDK 7.0.0

### Issues this closes

Closes getsentry/sentry-dotnet#5710

The other docs issues for 7.0.0 were closed when their PRs merged into
`dotnet-v7`.

### Before merging

- [x] sentry-dotnet 7.0.0 is on NuGet.
- [x] The release candidate alert is gone from
`includes/dotnet-v7-migration-overview.mdx`.
- [x] The links that #20311, #19961 and #19925 left for after the other
PRs merge are in.
- [x] `master` is merged into `dotnet-v7`, and the Vercel preview looks
right.
- [x] This description has a `Closes` line for every issue that's still
open.

## 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.

- [x] Urgent deadline (GA date, etc.): 2026-11-13
- [ ] Other deadline: YYYY-MM-DD
- [ ] No deadline: Not urgent, can wait up to 1 week+

---------

Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: James Crosswell <jamescrosswell@users.noreply.github.com>
Co-authored-by: ric-oliv <ric-oliv@users.noreply.github.com>
Co-authored-by: ric-oliv <5938598+ric-oliv@users.noreply.github.com>
Co-authored-by: Alex Krawiec <alex.krawiec@sentry.io>

This branch was successfully deployed

1 active deployment
Preview – sentry-docs — 20bfa9b1 Deployed Nov 9, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Urgent Docs review is needed immediately for an urgent deadline

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: list supported versions in the MAUI guide and remove Tizen

2 participants