Skip to content

Add Hosting integration architecture overview - #69242

Open
PureWeen wants to merge 5 commits into
dotnet:mainfrom
PureWeen:shneuvil-hosting-architecture
Open

PureWeen wants to merge 5 commits into
dotnet:mainfrom
PureWeen:shneuvil-hosting-architecture

Conversation

@PureWeen

@PureWeen PureWeen commented Sep 11, 2026 •

Copy link
Copy Markdown
Member

Add Hosting integration architecture overview

  • You've read the Contributor Guide and Code of Conduct.
  • You've included unit or integration tests for your change, where applicable.
  • You've included inline docs for your change, where applicable.
  • There's an open issue for the PR that you are making. If you'd like to propose a new feature or change, please open an issue to discuss the change or find an existing issue.

Add an in-area Hosting architecture reference.

Description

Add src/Hosting/ARCHITECTURE.md as an architecture reference for contributors and coding agents working across ASP.NET Core Hosting and src/DefaultBuilder.

The document describes the modern, Generic Host integration, and legacy Web Host models; builder and provider phases; Startup and middleware construction; server and lifetime boundaries; diagnostics; extensibility; and verification boundaries. It explicitly keeps the general-purpose Generic Host and dependency-injection container implementations under dotnet/runtime ownership.

This follows the in-area ARCHITECTURE.md pattern established by #69147. The change adds one new file only and does not modify production code, public APIs, dependencies, generated files, or repository instructions.

Validation

  • git diff --check origin/main...HEAD - passed
  • repository-relative Markdown links and heading anchors resolve
  • external documentation links resolve
  • markdownlint was not run locally

Related to #69011.

@github-actions github-actions Bot added the area-hosting Includes Hosting label Sep 11, 2026
@PureWeen PureWeen changed the title Document ASP.NET Core Hosting integration architecture Add Hosting integration architecture overview Sep 11, 2026
@PureWeen
PureWeen force-pushed the shneuvil-hosting-architecture branch from d2f1011 to 50c6029 Compare September 14, 2026 15:22
@PureWeen
PureWeen marked this pull request as ready for review September 14, 2026 15:22
@PureWeen
PureWeen requested a review from halter73 as a code owner September 14, 2026 15:22
@PureWeen
PureWeen requested a lite review from Copilot and removed request for Copilot September 14, 2026 15:22
@dotnet-policy-service

Copy link
Copy Markdown
Contributor

Looks like this PR hasn't been active for some time and the codebase could have been changed in the meantime.
To make sure no conflicting changes have occurred, please rerun validation before merging. You can do this by leaving an /azp run comment here (requires commit rights), or by simply closing and reopening.

@dotnet-policy-service dotnet-policy-service Bot added the pending-ci-rerun When assigned to a PR indicates that the CI checks should be rerun label Sep 26, 2026
Copilot AI added 4 commits October 1, 2026 15:49
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI lite review requested due to automatic review settings October 1, 2026 21:01
@PureWeen
PureWeen force-pushed the shneuvil-hosting-architecture branch from 50c6029 to 709441a Compare October 1, 2026 21:01
@PureWeen
PureWeen requested a review from SamMonoRT as a code owner October 1, 2026 21:01

Copilot AI 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.

Copilot review overview

🟢 Approval recommended

The only finding is a non-blocking documentation link nit.

Review effort: Lite
Findings: None

What changed in this PR

Adds a Hosting architecture overview and links it as orientation-only reviewer context.

Changes:

  • Documents Hosting models, boundaries, lifecycle, diagnostics, and verification.
  • Adds the Hosting overview to cross-cutting guidance.
File Description
src/​Hosting/​ARCHITECTURE.md New Hosting architecture documentation; one minor link correction noted.
docs/​CrossCuttingGuidance.md Adds the orientation-only Hosting overview link.

💡 Add a code-review agent skill for context-aware, tailored reviews. Learn more in the docs.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>

Copilot AI 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.

Copilot review overview

🟢 Approval recommended

The documentation aligns with the implementation, and its repository-relative links and anchors resolve correctly.

Review effort: Balanced
Findings: None

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area-hosting Includes Hosting pending-ci-rerun When assigned to a PR indicates that the CI checks should be rerun

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants