Document integrating build-generated files into static web assets

[Copilot]

fundamentals/static-files.md had no guidance for getting build-generated files (TypeScript output, bundled JS, or any custom build output) into the Map Static Assets pipeline so they gain fingerprinting, compression, and caching. This adds a section documenting the two maintainer-confirmed approaches (see dotnet/runtime#118146).

Changes

• New ## Integrate build-generated files into static web assets section in aspnetcore/fundamentals/static-files.md, within the >= aspnetcore-9.0 block, after "Static assets manifest" (where readers learn that files outside the build-time web root aren't served). Covers:
  • Link generated files into the web root — a <Content> item with Link metadata so a file stored outside wwwroot is discovered as a static web asset, plus a note that the file must exist when static web assets are resolved.
  • Use a JavaScript project for complex build pipelines — a separate Microsoft.VisualStudio.JavaScript.Sdk (.esproj) project referenced by the app, with the fluentui-blazor Assets project as an example.
• Metadata — bumped ms.date.

Link approach example

<ItemGroup>
  <Content Include="generated\main.js" Link="wwwroot\main.js"
    CopyToOutputDirectory="PreserveNewest" />
</ItemGroup>

Notes

• Intentionally avoids prescribing a specific SWA MSBuild target hook (e.g. ResolveCurrentProjectStaticWebAssetsInputsDependsOn), which the triage flagged as unverified for .NET 9+; the documented <Content Link> and .esproj paths are the ones confirmed by the runtime team.

• Fixes Guidance on integrating build generated files into Static Web Assets #36249

---

Internal previews

File	Preview link
aspnetcore/fundamentals/static-files.md	aspnetcore/fundamentals/static-files

[Copilot]

Pull request overview

Updates the Static files in ASP.NET Core documentation to add guidance for incorporating build-generated outputs (for example, TypeScript/bundled JavaScript) into the .NET 9+ static web assets / MapStaticAssets pipeline so they can benefit from fingerprinting, compression, and caching.

Changes:

• Adds a new Integrate build-generated files into static web assets section under the >= aspnetcore-9.0 content, documenting the <Content Link=...> approach and the .esproj/Microsoft.VisualStudio.JavaScript.Sdk approach.
• Makes broad editorial refinements throughout the article (rewording several paragraphs/headings).
• Updates ms.date.

---

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

[wadepickett]

@maraf, see the updated section here in preview: https://review.learn.microsoft.com/en-us/aspnet/core/fundamentals/static-files?view=aspnetcore-11.0&branch=pr-en-us-37545#integrate-build-generated-files-into-static-web-assets

[wadepickett]

@maraf, thanks for the great review suggestions. I have updated accordingly. Could you take a look and see if is good to go?