Skip to content

Follow up #568 with .NET docs reorganization#579

Open
davidfowl wants to merge 2 commits intorelease/13.2from
dotnet-isms-followup
Open

Follow up #568 with .NET docs reorganization#579
davidfowl wants to merge 2 commits intorelease/13.2from
dotnet-isms-followup

Conversation

@davidfowl
Copy link
Contributor

@davidfowl davidfowl commented Mar 22, 2026

Summary

Follow up #568 by restoring the broader .NET documentation reorganization that was described in the PR body but did not land in the merged diff.

This change:

  • moves Service Defaults into AppHost -> Project structure -> C# alongside Aspire SDK and Aspire templates
  • adds Integrations -> Frameworks & runtimes -> .NET with:
    • Project resources
    • C# file-based apps
    • Launch profiles
    • .NET tool resources
    • .NET MAUI
  • adds a new Project resources page that covers AddProject, ProjectReference metadata, launch profile behavior, Kestrel/endpoint behavior, proxies/replicas, and WithEndpointsInEnvironment
  • removes the remaining .NET-specific launch-profile, Kestrel, endpoint-filtering, and AddProject mechanics from Inner-loop networking overview, leaving a language-neutral overview with links to the dedicated .NET pages
  • moves the existing .NET-specific pages to the new routes and adds redirects from the old slugs
  • updates direct links and MAUI integration metadata to the new routes

Validation

  • cd src/frontend && npx astro telemetry disable && pnpm dev -- --host localhost --port 4321
    • local dev server started on http://localhost:4322/ because 4321 was already in use
  • verified 200 responses for:
    • /integrations/dotnet/project-resources/
    • /integrations/dotnet/csharp-file-based-apps/
    • /integrations/dotnet/launch-profiles/
    • /integrations/dotnet/dotnet-tool-resources/
    • /integrations/dotnet/maui/
    • /get-started/csharp-service-defaults/
    • /get-started/aspire-sdk-templates/
  • verified redirects for:
    • /fundamentals/service-defaults/
    • /ja/fundamentals/service-defaults/
    • /fundamentals/launch-profiles/
    • /ja/fundamentals/launch-profiles/
    • /app-host/dotnet-tool-resources/
    • /integrations/frameworks/csharp-file-based-apps/
    • /integrations/frameworks/maui/
  • verified rendered navigation HTML includes:
    • the .NET subsection under Frameworks & runtimes
    • the Project structure -> C# links for Aspire SDK, Aspire templates, and Service Defaults
  • verified the rendered English and Japanese Inner-loop networking overview pages:
    • return 200
    • link to C# launch profiles / Project resources
    • no longer render the moved .NET-specific launch profile, Kestrel, ASPNETCORE_URLS, DOTNET_LAUNCH_PROFILE, AddProject, or dotnet dev-certs content

Restore the broader .NET docs IA that #568 described but that did not land in the merged diff.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Move the remaining launch-profile, project-resource, and .NET-specific inner-loop networking details behind links to the dedicated .NET docs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
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.

1 participant