Skip to content

Options article overhaul#36720

Open
guardrex wants to merge 8 commits intomainfrom
guardrex/options-article-overhaul
Open

Options article overhaul#36720
guardrex wants to merge 8 commits intomainfrom
guardrex/options-article-overhaul

Conversation

@guardrex
Copy link
Collaborator

@guardrex guardrex commented Jan 30, 2026

Fixes #36220

Tom .....

  • I placed Razor component examples in every section for >=8.0, while retaining updated Razor Pages examples for <8.0.
  • Dropping the bloatware 😆 samps ... IMO, they're not necessary for such simple guidance, not particularly well maintained (ancient .NET targets), not particularly easy to use, not particularly well programmed, and bloating the repo with a gazillion files. I think the simple cut-'n-paste, fully working examples that are in the text here are easy for devs to drop into a sample if they want to play with them. I also place the output under the examples showing what will be rendered.
  • I updated the API cross-links.
  • Dropping the INCLUDES versioning! 🎉 No broken links, no duplicate content, and easier to maintain IMO.
  • For the Use DI services to configure options section (and its pair of subsections), fully working demo code would be nice, but I don't have time right now to flesh them out. These have obviously always been considered advanced scenarios. I guess they could stay like this. If you want them fleshed out, I'll leave it to you to open an issue, but I have tons 🐘 of work to do elsewhere for the foreseeable future, so I think it would fall to you, Wade, or a community cat to resolve such an issue.

... and BTW ...

I plan to return to the Middleware overhaul PR tomorrow (Wednesday) to see if I can shed the INCLUDES file on that one. Done! 👍 on #36616.


Internal previews

📄 File 🔗 Preview link
aspnetcore/blazor/fundamentals/configuration.md aspnetcore/blazor/fundamentals/configuration
aspnetcore/fundamentals/configuration/index.md aspnetcore/fundamentals/configuration/index
aspnetcore/fundamentals/configuration/options.md aspnetcore/fundamentals/configuration/options

@guardrex guardrex self-assigned this Jan 30, 2026
@guardrex guardrex marked this pull request as ready for review February 3, 2026 16:34
@guardrex
Copy link
Collaborator Author

guardrex commented Feb 3, 2026

@copilot ... review this PR.

Copy link
Contributor

Copilot AI commented Feb 3, 2026

@guardrex I've opened a new pull request, #36738, to work on those changes. Once the pull request is ready, I'll request review from you.

@guardrex guardrex requested a review from tdykstra February 3, 2026 16:52
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.

Update the Options article to be based on Blazor

2 participants