Skip to content

Refresh Aspire documentation for 13.5 - #128760

Open
David Pine (IEvangelist) wants to merge 1 commit into
MicrosoftDocs:mainfrom
IEvangelist:ievangelist-refresh-aspire-documentation
Open

Refresh Aspire documentation for 13.5#128760
David Pine (IEvangelist) wants to merge 1 commit into
MicrosoftDocs:mainfrom
IEvangelist:ievangelist-refresh-aspire-documentation

Conversation

@IEvangelist

Copy link
Copy Markdown
Member

Summary

This PR refreshes Azure's Aspire documentation against the latest stable release, Aspire 13.5.3.

  • Rebrands every visible .NET Aspire reference to Aspire across the repository.
  • Replaces all legacy Learn /dotnet/aspire links with canonical, live aspire.dev destinations.
  • Renames all three article slugs containing dotnet-aspire and adds direct permanent redirects:
    • app-service/quickstart-dotnet-aspireapp-service/quickstart-aspire
    • app-service/configure-language-dotnet-aspireapp-service/configure-language-aspire
    • azure-functions/dotnet-aspire-integrationazure-functions/aspire-integration
  • Updates every inbound TOC, index, include, cross-article, and media reference to the new slugs.
  • Refreshes App Service, Azure Functions, Azure App Configuration, and Azure Container Apps guidance for current Aspire CLI commands, prerequisites, AppHost conventions, APIs, deployment behavior, and support status.
  • Adds contextual “For more information...” links to current Aspire concepts, integrations, command references, deployment guides, and API references.
  • Replaces nine screenshots that showed the pre-13.5 dashboard with newly captured Aspire 13.5.3 UI.

Notable freshness changes

  • Replaces legacy azd-first App Service instructions with aspire deploy and aspire destroy while retaining Azure CLI authentication.
  • Documents the App Service integration's preview status, automatic compute targeting, endpoint constraints, and stable 13.5.3 customization APIs.
  • Removes historical Azure Functions 13.0/13.1 release-candidate guidance and documents current C#/TypeScript AppHost support, package setup, local settings precedence, and deployment paths.
  • Updates App Configuration setup to use aspire add, current Aspire.AppHost.Sdk conventions, AsExisting, aspire run, and current feature-management refresh APIs.
  • Adds an Aspire CLI pivot for the Azure Container Apps dashboard flow and updates dashboard/telemetry descriptions.

Validation

  • Confirmed no visible .NET Aspire text remains.
  • Confirmed no legacy /dotnet/aspire links remain.
  • Confirmed the only remaining dotnet-aspire strings are the three intentional redirect source paths.
  • Verified all 47 added external links return HTTP 200 and all added aspire.dev anchors exist.
  • Parsed all changed JSON, YAML, and Markdown front matter successfully.
  • Verified renamed-page redirects are unique, direct, and target existing files.
  • Verified all changed local links and image references resolve.
  • Compiled the Azure App Configuration dynamic refresh and feature flag samples against Aspire 13.5.3.
  • Compiled the Azure App Service customization sample against the stable Aspire 13.5.3 package API.
  • Ran git diff --check successfully.

Update Aspire branding, canonical links, article slugs, redirects, tooling guidance, APIs, and dashboard screenshots across the affected Azure documentation.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@prmerger-automator

Copy link
Copy Markdown
Contributor

David Pine (@IEvangelist) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

1 similar comment
@prmerger-automator

Copy link
Copy Markdown
Contributor

David Pine (@IEvangelist) : Thanks for your contribution! The author(s) and reviewer(s) have been notified to review your proposed change.

@learn-build-service-prod

Copy link
Copy Markdown
Contributor

Learn Build status updates of commit ab799c2:

✅ Validation status: passed

File Status Preview URL Details
articles/app-service/configure-language-aspire.md ✅Succeeded
articles/app-service/configure-language-dotnet-aspire.md ✅Succeeded n/a (file deleted or renamed)
articles/app-service/index.yml ✅Succeeded
articles/app-service/media/quickstart-aspire/aspire-dashboard.png ✅Succeeded
articles/app-service/media/quickstart-aspire/resource-group-view.png ✅Succeeded
articles/app-service/media/quickstart-dotnet-aspire/aspire-dashboard.png ✅Succeeded n/a (file deleted or renamed)
articles/app-service/media/quickstart-dotnet-aspire/resource-group-view.png ✅Succeeded n/a (file deleted or renamed)
articles/app-service/quickstart-aspire.md ✅Succeeded
articles/app-service/quickstart-dotnet-aspire.md ✅Succeeded n/a (file deleted or renamed)
articles/app-service/toc.yml ✅Succeeded
articles/azure-app-configuration/emulator-overview.md ✅Succeeded
articles/azure-app-configuration/enable-dynamic-configuration-aspire.md ✅Succeeded
articles/azure-app-configuration/media/aspire/azure-subscription.png ✅Succeeded
articles/azure-app-configuration/media/aspire/dashboard-emulator.png ✅Succeeded
articles/azure-app-configuration/media/aspire/dashboard-logs.png ✅Succeeded
articles/azure-app-configuration/media/aspire/dashboard-updated.png ✅Succeeded
articles/azure-app-configuration/media/aspire/dashboard.png ✅Succeeded
articles/azure-app-configuration/media/aspire/resource-provisioned.png ✅Succeeded
articles/azure-app-configuration/media/aspire/resource-provisioning.png ✅Succeeded
articles/azure-app-configuration/quickstart-aspire.md ✅Succeeded
articles/azure-app-configuration/quickstart-feature-flag-aspire.md ✅Succeeded
articles/azure-functions/.openpublishing.redirection.azure-functions.json ✅Succeeded
articles/azure-functions/aspire-integration.md ✅Succeeded
articles/azure-functions/dotnet-aspire-integration.md ✅Succeeded n/a (file deleted or renamed)
articles/azure-functions/dotnet-isolated-in-process-differences.md ✅Succeeded

This comment lists only the first 25 files in the pull request.
For more details, please refer to the build report.

@prmerger-automator

Copy link
Copy Markdown
Contributor

PRMerger Results

Issue Description
Added File(s) This PR contains added files. New files require human review.
Yaml File(s) This PR includes changes to .yml file(s) owned by another author.
Changed Files This PR contains more than 10 changed files.
File Change Percent This PR contains file(s) with more than 30% file change.
Image File This PR added or updated an image file(s).
Json File This PR contains json file(s).
Zone Pivot Groups This PR contains a zone-pivot-groups.yml file.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants