Skip to content

Fundamentals > App startup article overhaul - #37591

Open
guardrex wants to merge 6 commits into
mainfrom
guardrex/fundamentals-startup
Open

guardrex wants to merge 6 commits into
mainfrom
guardrex/fundamentals-startup

Conversation

@guardrex

@guardrex guardrex commented Sep 4, 2026

Copy link
Copy Markdown
Collaborator

Fixes #37590
Addresses #34356

Notes

Ilona ... Would you see if I made technical mistakes or left anything important out? The main focus is the new content for >=6.0 at the top of the Startup article (on the diff here). It's not very much content, and I hope it won't take you much time to look over.

Wade ... Per our brief convo on the Fundamentals overview PR, we might need to discuss these in-repo samples further. I don't understand the concern about dropping them. IMO, the tutorials, such as the Blazor tutorials, are the best way to walk a dev through working code for base case learning scenarios. Then, advanced samples exist for difficult concepts that run under recent/current .NET versions with modern tooling and C# language versions that are easily accessible for inspection and download.

  • There's repo bloat here with samples that ...
    • Either don't compile and/or target out-of-support versions of .NET.
    • Never adopted the promise that they would be built by the repo build system (although that can be set up).
    • Not accessible for inspection or download by readers, only providing article snippet code.
    • Are confusing with the compiler directive demo approach.
    • Are overkill for the simple points that the text is making.
    • Bloating the repo (>189 thousand lines in ~165 files).
  • There's little info on what's actually happening during startup, including for the <6.0 content, so I've written out some guidance to help devs understand app startup. I'm focusing that content on >=6.0, but I can expand it back into the <6.0 part of the article if desired.
  • WRT the Startup class coverage only appearing for <6.0 in spite of current support, I think that was a management decision because the PU wants devs to focus on the minimal hosting model. We have some current version content to cross-link the article's 5.0 version if a dev is upgrading an app and looking for the coverage. I left this paradigm in place for the Startup class coverage.
  • ServerReady/startup performance is worth a mention, but I place a new, short section on it in the Logging overview (as an EventSource subsection) and cross-link to it there.
  • IMO, the startup filters section includes an overkill example that's easily demonstrated with two cut-'n-paste snippets. I revised and hopefully improved the content. I refer readers to the middleware coverage for further details on the middleware aspects.

Internal previews

File Preview link
aspnetcore/fundamentals/configuration/index.md Learn preview
aspnetcore/fundamentals/logging/index.md Learn preview
aspnetcore/fundamentals/startup.md Learn preview
aspnetcore/migration/31-to-60.md Learn preview
aspnetcore/migration/50-to-60-samples.md Learn preview
aspnetcore/migration/50-to-60.md Learn preview
aspnetcore/test/integration-tests.md Learn preview
aspnetcore/test/integration-tests/includes/integration-tests7.md Learn preview
aspnetcore/test/integration-tests/includes/integration-tests8.md Learn preview
aspnetcore/test/integration-tests/includes/integration-tests9.md Learn preview

Build report

@guardrex
guardrex force-pushed the guardrex/fundamentals-startup branch from 2a0ed77 to f8c5978 Compare September 8, 2026 11:44

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.

🟡 Changes recommended

The updated aspnetcore/fundamentals/startup.md content includes a broken code sample and a malformed link that should be corrected before merge.

Once you've addressed the issues Copilot identified, you can request another Copilot review.

Pull request overview

Updates the App startup and related Fundamentals documentation to better explain the modern hosting/startup flow, refresh cross-links to the updated startup filter section, and remove legacy in-repo sample assets that no longer appear to be needed.

Changes:

  • Overhauled fundamentals/startup guidance (Program-based startup flow, startup filters section, and related links).
  • Updated cross-references in integration testing + migration + configuration docs to point at the new/updated heading anchors.
  • Added a ServerReady/startup-time note under the logging EventSource provider and refreshed ms.date metadata on touched articles.
File summaries
File Description
aspnetcore/fundamentals/startup.md Startup article overhaul; adds/adjusts sections and anchors referenced elsewhere.
aspnetcore/fundamentals/logging/index.md Adds ServerReady note under EventSource; updates metadata.
aspnetcore/fundamentals/configuration/index.md Updates cross-link to the startup convenience-methods section anchor.
aspnetcore/test/integration-tests.md Updates reference to use IStartupFilter and points to the new startup filters anchor; updates metadata.
aspnetcore/test/integration-tests/includes/integration-tests7.md Same cross-link update for .NET 7 include.
aspnetcore/test/integration-tests/includes/integration-tests8.md Same cross-link update for .NET 8 include.
aspnetcore/test/integration-tests/includes/integration-tests9.md Same cross-link update for .NET 9 include.
aspnetcore/migration/50-to-60.md Removes legacy named anchors and updates a heading used for linking.
aspnetcore/migration/50-to-60-samples.md Updates link to the new “New hosting model” heading anchor.
aspnetcore/migration/31-to-60.md Updates link to the renamed “Use a Startup class…” heading anchor.
aspnetcore/fundamentals/startup/** (legacy samples) Removes older startup sample snapshots and bundled static assets under versioned sample folders.
Review details
  • Files reviewed: 134/174 changed files
  • Comments generated: 2
  • Review effort level: Lite

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

Comment thread aspnetcore/fundamentals/startup.md Outdated
Comment thread aspnetcore/fundamentals/startup.md Outdated
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@guardrex
guardrex requested a review from ilonatommy September 9, 2026 15:26
@guardrex
guardrex marked this pull request as ready for review September 9, 2026 19:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

App startup Blazor/Minimal API updates

2 participants