Skip to content

Static files overhaul #35967

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 9 commits into
base: main
Choose a base branch
from
Open

Static files overhaul #35967

wants to merge 9 commits into from

Conversation

guardrex
Copy link
Collaborator

@guardrex guardrex commented Aug 20, 2025

Fixes #35810
Fixes #35833

Dan ... I'll ping Javier for a technical review after I get your feedback. Next, I'll ping Wade and Tom.

Notes

  • Let's combine articles. IMO, it's kind'a scatter-🧠 to have two static files articles.
  • 'Look ma! No broken links!' 😆 Let's drop the horribad INCLUDES versioning for two great outcomes ...
    • Links aren't broken in prior-version content.
    • The team and community are prevented from only updating the latest version of the article. That will still be a problem if we ever go to group-topic versioning (aka "Version-by-file"), but I don't think that's ever going to happen. If we're on the current versioning model forever, this approach stops the poor practice of only making bug fixes to the latest release content (i.e., INCLUDES files are routinely ignored for bug and enhancement updates).
  • Let's move the samples into the dotnet/AspNetCore.Docs.Samples repo where they belong. The sample apps were placed in that repo on Add static files sample apps AspNetCore.Docs.Samples#282. I'll delete them from this repo on this PR after reviews to avoid cluttering the diff.
  • We're still running with the separate Blazor Static Files article with Blazor-focused scenarios. Dan, I can move that content (or selected bits of it) into this article if you want. 👂

Internal previews

📄 File 🔗 Preview link
aspnetcore/blazor/fundamentals/static-files.md aspnetcore/blazor/fundamentals/static-files
aspnetcore/fundamentals/static-files.md aspnetcore/fundamentals/static-files
aspnetcore/toc.yml aspnetcore/toc

@guardrex guardrex self-assigned this Aug 20, 2025
@guardrex guardrex marked this pull request as ready for review August 20, 2025 15:54
@guardrex guardrex requested a review from Copilot August 20, 2025 16:08
Copilot

This comment was marked as outdated.

@guardrex guardrex requested a review from danroth27 August 20, 2025 16:27
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.

[static-files] Missing information or sample code content Static assets article(s) updates
1 participant