Skip to content

Fundamentals overview article overhaul - #37568

Merged
guardrex merged 9 commits into
mainfrom
guardrex/fundamentals-overview
Sep 4, 2026
Merged

Fundamentals overview article overhaul#37568
guardrex merged 9 commits into
mainfrom
guardrex/fundamentals-overview

Conversation

@guardrex

@guardrex guardrex commented Sep 1, 2026

Copy link
Copy Markdown
Collaborator

Fixes #37558
Addresses #34356

  • Focusing on Blazor and Minimal APIs throughout. Keeping references to MVC and RP where appropriate for older versions.
  • Improving, usually simplifying, some examples that I feel show a lot of code and complexity to make simple points for introductory/fundamentals reading. Let's see on review if I went too far 🙈😄.
  • Shedding the INCLUDES versioning, which fixes the broken links in prior release content and cuts content duplication. 🎉
  • For some sections, I knock out detailed feature content in favor of allowing the subject matter articles in those areas handle the coverage. It leans some of the sections more in the direction of a general overview.
  • I'm rewriting a few of the sections to make them simpler for new-to-.NET devs and new-to-programming devs. This is an early article, so I hope we can avoid relying too much on prior knowledge.
  • Drop these sample apps that are bloating the repo, not linked for reader download/use, and out of date. It simplifies and reduces the cost 💸 of maintaining the article and doc set. The stable code that was supplied is easily inlined for the shorter examples.
  • Let's move the Environments section UP to place it before other sections that mention execution environments.
  • Let's move the general guidance on the definition of DOM, byte multiples, and support requests to the main Fundamentals overview article and out of Blazor's Fundamentals overview article. I edited the content so that it applies to the entire doc set.

Internal previews

File Preview link
aspnetcore/blazor/fundamentals/index.md Learn preview
aspnetcore/fundamentals/index.md Learn preview
aspnetcore/fundamentals/index/snapshot/Program10.cs Learn preview
aspnetcore/fundamentals/index/snapshot/Program11.cs Learn preview
aspnetcore/fundamentals/index/snapshot/Program6.cs Learn preview
aspnetcore/fundamentals/index/snapshot/Program8.cs Learn preview
aspnetcore/fundamentals/index/snapshot/Startup3.cs Learn preview
aspnetcore/fundamentals/static-files.md Learn preview

Build report

@guardrex guardrex self-assigned this Sep 2, 2026
@guardrex
guardrex marked this pull request as ready for review September 3, 2026 11:42
@guardrex
guardrex requested a review from tdykstra as a code owner September 3, 2026 11:42

This comment was marked as resolved.

guardrex and others added 2 commits September 3, 2026 10:50
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
@guardrex
guardrex requested a review from wadepickett September 3, 2026 15:18
Comment thread aspnetcore/fundamentals/index/snapshot/Program8.cs

@wadepickett wadepickett 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.

@guardrex: Approved. I think it is better. Well done. Outside of this immediate PR we should have a good lively discussion on the pro-cons and "when if'"s of moving compilable code examples to non-compilable snapsots on any large scale of overhalls so we have some consistant direction with the outcome we want.

@guardrex

guardrex commented Sep 4, 2026

Copy link
Copy Markdown
Collaborator Author

I agree. Let's take it up next week while still working on this PR. We'll probably come up with some improvements to this.

@wadepickett

wadepickett commented Sep 4, 2026

Copy link
Copy Markdown
Contributor

I agree. Let's take it up next week while still working on this PR. We'll probably come up with some improvements to this.

This PR is fine (unless the scope for some reason increases ), but for outside of this PR's scope good to figure out more generally what other types of content fit the move to uncompiled snapshot files and what doesn't, and when at least one clean compilable working example is warrented even when using snapshots.

@tdykstra just for CC as we think about this going forward.

@wadepickett

Copy link
Copy Markdown
Contributor

@guardrex: This PR is approved and can be squashed and merged.

@guardrex
guardrex merged commit a667e25 into main Sep 4, 2026
5 checks passed
@guardrex
guardrex deleted the guardrex/fundamentals-overview branch September 4, 2026 22:12
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.

Fundamentals overview article updates for Blazor/Minimal API work

3 participants