Static assets article(s) updates

[guardrex]

Description

Pick up from round one ...

• ✨ Blazor-fy!™ ✨ the article.
• Edit pass on the whole doc.
• Try to combine the two static assets articles into one article, or possibly clean them up and place them in a node under one ToC entry.

WRT the heading ...

Map Static Assets routing endpoint conventions (MapStaticAssets)

First ...

This heading is incomprehensible; Can it be made clear, maybe by dividing it up into multiple sections?

I think we do need some kind of introduction to this article, something that explains what the web root is and what the content root is, what static assets are, what static files are, what it means to "map to static assets," etc.

Second ...

Somewhere we need a high level conceptual overview of/intro to "map static assets" vs. "use static files".

Third (Line 139) ...

Static file authorization seems like a topic that would be more appropriate in this article than in the fundamentals overview

Additional feedback ...

I don't think the "Serve files outside of web root" section has much relevance to the topic of the page, if any. It just repeats the information on the other page for static files. It doesn't actually tell how to serve assets outside the web root as one could assume, furthermore, it is NOT possible currently with just its own features, so all it does is just sew confusion. The same goes for "Set HTTP response headers", "Serve files from multiple locations" and "Serve files outside wwwroot by updating IWebHostEnvironment.WebRootPath". In fact, the 2d section is wrong still because it is written for static files except in the last line of the example code, where it finally invokes MapStaticAssets(). And the 3d section confuses the hell out of me, which is shared feedback to both pages, is it really "serving files outside wwwroot" if you change its very location? Neither of the pages really need it, and instead it could just be a section in the ASP.NET configuration page about the web root, if there is none right now, I forget.

Also, the title of the page should use the word "assets" instead of "files".

Page URL

https://learn.microsoft.com/en-us/aspnet/core/fundamentals/map-static-files?view=aspnetcore-10.0

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/fundamentals/map-static-files.md

Document ID

927e39a4-a6d4-d5b8-8aa2-4fa2e04ea75b

Platform Id

22b989a7-6b18-6b75-3391-72de8d1b5a88

Article author

@guardrex

Metadata

• ID: 927e39a4-a6d4-d5b8-8aa2-4fa2e04ea75b
• PlatformId: 22b989a7-6b18-6b75-3391-72de8d1b5a88
• Service: aspnet-core
• Sub-service: fundamentals

Related Issues