Skip to content

docs(dotnet): Link the Generic Host guide from the other .NET pages for SDK 7.0.0 - #20742

Merged
jamescrosswell merged 2 commits into
dotnet-v7from
dotnet-v7-link-generic-host-guide
Nov 12, 2026
Merged

jamescrosswell merged 2 commits into
dotnet-v7from
dotnet-v7-link-generic-host-guide

Conversation

@jamescrosswell

Copy link
Copy Markdown
Collaborator

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

#20311 added the Generic Host guide (/platforms/dotnet/guides/extensions-hosting/). Only the Microsoft.Extensions.Logging guide linked to it. This adds links from the other pages that tell generic host apps to call UseSentry:

  • Azure Functions guide: links the guide for the options UseSentry takes.
  • Logs: the Generic Host paragraph in the Microsoft.Extensions.Logging logs setup, and a Generic Host entry in the .NET logs integrations list.
  • Logs and Metrics getting-started pages: a Generic Host entry in the .NET lists.
  • 7.0 migration guide: the overview, "Generic Host Apps Call UseSentry", and the Generic Host row of the table in "Logging Integrations No Longer Initialize Sentry".
  • Environment option: links ".NET Generic Host".

Closes getsentry/sentry-dotnet#5912

Notes for review

  • "Update All Sentry Packages Together" names Sentry.Extensions.Hosting too, but it already links to "Generic Host Apps Call UseSentry", which now links the guide. I left it alone rather than add a second link in the same paragraph.
  • dotnet.extensions-hosting has no entry in platformIcon.tsx, so the new list entries fall back to the .NET icon, the same as Microsoft.Extensions.Logging.

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+

🤖 Generated with Claude Code

…or SDK 7.0.0

Link /platforms/dotnet/guides/extensions-hosting/ from the Azure Functions
guide, the logs setup and integrations lists, the logs and metrics
getting-started pages, the 7.0 migration guide and the Environment option.

Refs getsentry/sentry-dotnet#5912

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

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

Request Review

@github-actions github-actions Bot added the Priority: Urgent Docs review is needed immediately for an urgent deadline label Nov 12, 2026
@codeowner-assignment
codeowner-assignment Bot requested a review from a team November 12, 2026 01:51
@jamescrosswell
jamescrosswell marked this pull request as ready for review November 12, 2026 02:06
@codeowner-assignment
codeowner-assignment Bot requested a review from a team November 12, 2026 02:06
@cursor

cursor Bot commented Nov 12, 2026

Copy link
Copy Markdown
Contributor

Getting ready to monitor this change · Rollout details

Status Service Environment
⏳ Getting ready to monitor this change

@ric-oliv ric-oliv left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Looking good!

@ric-oliv

Copy link
Copy Markdown
Member

Optional, and outside the diff: this line still sends Azure Functions readers to the Microsoft.Extensions.Logging guide for setup details.

See [Microsoft.Extensions.Logging](/platforms/dotnet/guides/extensions-logging/) for setup details.

That guide's setup is for apps without a host, and it tells generic host apps to go to the Generic Host guide instead. What do you think about linking the Generic Host guide's Send Logs section there directly?

See [Generic Host](/platforms/dotnet/guides/extensions-hosting/#send-logs) for setup details.

@coolguyzone coolguyzone left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Looks good, thanks for keep this up to date!

… Host guide

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@codeowner-assignment
codeowner-assignment Bot requested review from a team November 12, 2026 20:48
@jamescrosswell
jamescrosswell merged commit 7855cdb into dotnet-v7 Nov 12, 2026
12 checks passed
@jamescrosswell
jamescrosswell deleted the dotnet-v7-link-generic-host-guide branch November 12, 2026 21:04
@ric-oliv ric-oliv mentioned this pull request Nov 13, 2026
6 of 8 tasks
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 — bb024cba Deployed Nov 12, 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.

3 participants