Skip to content

Remove 'dotnet' prefix from aka.ms/aspire shortlinks#16176

Merged
adamint merged 2 commits intomainfrom
dev/adamint/remove-dotnet-from-aka-shortlinks
Apr 23, 2026
Merged

Remove 'dotnet' prefix from aka.ms/aspire shortlinks#16176
adamint merged 2 commits intomainfrom
dev/adamint/remove-dotnet-from-aka-shortlinks

Conversation

@adamint
Copy link
Copy Markdown
Member

@adamint adamint commented Apr 14, 2026 •
edited
Loading

Description

Remove the dotnet prefix from all aka.ms/dotnet/aspire/* shortlinks, updating them to aka.ms/aspire/* across the repository.

Summary of changes:

  • Updated 96 files (164 insertions, 164 deletions) across source code, project templates, localization files (.xlf, .json), Razor components, resource files (.resx), and tests
  • Covers 17 unique shortlink suffixes: service-defaults, healthchecks, containers, diagnostics, update-latest, allowunsecuredtransport, testing, repo, cardinality-limits, copilot-pro, copilot-vs-login, copilot-vscode-login, copilot-free-signup, azcli, azure/provisioning, dashboard, microsoft-collected-telemetry

Preserved (intentionally unchanged):

  • https://aka.ms/dotnet/aspire/container-runtime-unhealthy — kept as-is (being changed in separate pr)
  • AnalyzerReleases.Shipped.md — release notes should not be modified
  • /eng/ directory — excluded from scope

Checklist

  • Is this feature complete?
    • Yes. Ready to ship.
    • No. Follow-up changes expected.
  • Are you including unit tests for the changes and scenario tests if relevant?
    • Yes
    • No
  • Did you add public API?
    • Yes
    • No
  • Does the change make any security assumptions or guarantees?
    • Yes
    • No
  • Does the change require an update in our Aspire docs?
    • Yes
    • No

@adamint
Remove 'dotnet' prefix from aka.ms/aspire shortlinks
4585009 
Updated all aka.ms/dotnet/aspire/* shortlinks to aka.ms/aspire/* across
96 files including source code, templates, localization files, and tests.

Preserved aka.ms/dotnet/aspire/container-runtime-unhealthy (unchanged).
Skipped AnalyzerReleases.Shipped.md (release notes) and /eng/ directory.
Copilot AI review requested due to automatic review settings April 14, 2026 21:48
Copilot AI reviewed Apr 14, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Note

Copilot was unable to run its full agentic suite in this review.

This PR updates Aspire documentation shortlinks across the repository by removing the dotnet prefix, changing https://aka.ms/dotnet/aspire/* to https://aka.ms/aspire/*.

Changes:

  • Replaced aka.ms/dotnet/aspire/* links with aka.ms/aspire/* in product code paths (hosting, CLI, dashboard).
  • Updated project templates and localization resources (.json, .xlf, .resx) to match the new shortlink format.
  • Updated tests that assert link text/URLs to reflect the new shortlinks.

Reviewed changes

Copilot reviewed 94 out of 96 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
tests/TestingAppHost1/TestingAppHost1.ServiceDefaults/Extensions.cs Updates service-defaults and healthchecks shortlinks in template/test service defaults comments.
tests/Aspire.Hosting.Tests/Dcp/DcpHostNotificationTests.cs Updates asserted container docs URL in DCP notification tests.
tests/Aspire.Hosting.Tests/Dashboard/TransportOptionsValidatorTests.cs Updates asserted allow-unsecured-transport docs URL in validator tests.
tests/Aspire.Hosting.RemoteHost.Tests/CapabilityDispatcherTests.cs Updates networking docs URL in an error capability test.
tests/Aspire.Cli.Tests/Mcp/Docs/LlmsTxtParserTests.cs Updates embedded update-latest link in docs parsing test content.
src/Aspire.ProjectTemplates/templates/aspire-ts-cs-starter/Aspire-StarterApplication.1.Server/Extensions.cs Updates service-defaults/healthchecks shortlinks in template code comments.
src/Aspire.ProjectTemplates/templates/aspire-starter/Aspire-StarterApplication.1.ServiceDefaults/Extensions.cs Updates service-defaults/healthchecks shortlinks in template code comments.
src/Aspire.ProjectTemplates/templates/aspire-servicedefaults/Extensions.cs Updates service-defaults/healthchecks shortlinks in template code comments.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.zh-Hant.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.zh-Hans.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.tr.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.ru.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.pt-BR.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.pl.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.ko.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.ja.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.it.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.fr.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.es.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.de.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-js-frontend-starter/.template.config/localize/templatestrings.cs.json Updates containers shortlink in localized template strings.
src/Aspire.ProjectTemplates/templates/aspire-empty/AspireApplication.1.ServiceDefaults/Extensions.cs Updates service-defaults/healthchecks shortlinks in template code comments.
src/Aspire.Hosting/VersionChecking/VersionCheckService.cs Updates update-latest shortlink used by version check notification.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.zh-Hant.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.zh-Hans.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.tr.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.ru.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.pt-BR.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.pl.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.ko.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.ja.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.it.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.fr.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.es.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.de.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/xlf/InteractionStrings.cs.xlf Updates containers shortlink in localized interaction strings.
src/Aspire.Hosting/Resources/InteractionStrings.resx Updates containers shortlink in primary resource string.
src/Aspire.Hosting/DistributedApplication.cs Updates testing shortlink in XML docs.
src/Aspire.Hosting/Dcp/DcpHost.cs Updates containers shortlink used by runtime notification.
src/Aspire.Hosting/Dcp/DcpDependencyCheck.cs Updates containers shortlink in logs/exceptions for runtime checks.
src/Aspire.Hosting/Dashboard/TransportOptionsValidator.cs Updates allowunsecuredtransport shortlink in validation errors.
src/Aspire.Hosting.Azure/api/Aspire.Hosting.Azure.cs Updates diagnostics shortlink used in Experimental attribute metadata.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.zh-Hant.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.zh-Hans.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.tr.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.ru.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.pt-BR.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.pl.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.ko.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.ja.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.it.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.fr.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.es.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.de.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/xlf/AzureProvisioningStrings.cs.xlf Updates azure/provisioning shortlink in localized provisioning strings.
src/Aspire.Hosting.Azure/Resources/AzureProvisioningStrings.resx Updates azure/provisioning shortlink in primary resource string.
src/Aspire.Hosting.Azure/Provisioning/Provisioners/AzureProvisioner.cs Updates azcli and azure/provisioning shortlinks in provisioning errors.
src/Aspire.Hosting.Azure/PrivateEndpointTargetAnnotation.cs Updates diagnostics shortlink in Experimental attribute metadata.
src/Aspire.Hosting.Azure/IAzurePrivateEndpointTarget.cs Updates diagnostics shortlink in Experimental attribute metadata.
src/Aspire.Hosting.Azure/IAzureNspAssociationTarget.cs Updates diagnostics shortlink in Experimental attribute metadata.
src/Aspire.Hosting.Azure/IAzureDelegatedSubnetResource.cs Updates diagnostics shortlink in Experimental attribute metadata.
src/Aspire.Hosting.Azure/DelegatedSubnetAnnotation.cs Updates diagnostics shortlink in Experimental attribute metadata.
src/Aspire.Hosting.Azure/AzureEnvironmentResource.cs Updates diagnostics shortlink in Experimental attribute metadata.
src/Aspire.Hosting.Azure.Sql/api/Aspire.Hosting.Azure.Sql.cs Updates diagnostics shortlink in Experimental attribute metadata.
src/Aspire.Hosting.Azure.Sql/AzureSqlExtensions.cs Updates diagnostics shortlink in Experimental attribute metadata.
src/Aspire.Hosting.Azure.Network/AssemblyInfo.cs Updates diagnostics shortlink in assembly-level Experimental metadata.
src/Aspire.Dashboard/Resources/xlf/Columns.zh-Hant.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/Resources/xlf/Columns.zh-Hans.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/Resources/xlf/Columns.tr.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/Resources/xlf/Columns.ru.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/Resources/xlf/Columns.pt-BR.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/Resources/xlf/Columns.pl.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/Resources/xlf/Columns.ko.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/Resources/xlf/Columns.ja.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/Resources/xlf/Columns.it.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/Resources/xlf/Columns.fr.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/Resources/xlf/Columns.es.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/Resources/xlf/Columns.de.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/Resources/xlf/Columns.cs.xlf Updates container-runtime-unhealthy shortlink in localized dashboard text.
src/Aspire.Dashboard/README.md Updates telemetry collection shortlink in dashboard README.
src/Aspire.Dashboard/Components/Layout/MobileNavMenu.razor.cs Updates repo shortlink opened from the mobile nav menu.
src/Aspire.Dashboard/Components/Layout/MainLayout.razor Updates repo shortlink used by the header repo link.
src/Aspire.Dashboard/Components/Dialogs/HelpDialog.razor Updates dashboard help shortlink.
src/Aspire.Dashboard/Components/Controls/Chart/ChartContainer.razor Updates cardinality-limits shortlink in overflow message.
src/Aspire.Dashboard/Components/Controls/AssistantChat.razor Updates Copilot-related shortlinks for help/error text.
src/Aspire.Cli/Utils/EnvironmentChecker/ContainerRuntimeCheck.cs Updates containers shortlink returned in environment check results.
playground/seq/Seq.ServiceDefaults/Extensions.cs Updates service-defaults/healthchecks shortlinks in playground service defaults comments.
playground/orleans/OrleansServiceDefaults/Extensions.cs Updates service-defaults/healthchecks shortlinks in playground service defaults comments.
playground/TestShop/TestShop.ServiceDefaults/Extensions.cs Updates service-defaults/healthchecks shortlinks in playground service defaults comments.
playground/Playground.ServiceDefaults/Extensions.cs Updates service-defaults/healthchecks shortlinks in playground service defaults comments.
playground/AspireWithNode/AspireWithNode.ServiceDefaults/Extensions.cs Updates healthchecks shortlink in playground service defaults comment.
playground/AspireWithMaui/AspireWithMaui.ServiceDefaults/Extensions.cs Updates service-defaults/healthchecks shortlinks in playground service defaults comments.
playground/AspireWithMaui/AspireWithMaui.MauiServiceDefaults/Extensions.cs Updates service-defaults shortlink in playground service defaults comment.
playground/AspireWithJavaScript/AspireJavaScript.ServiceDefaults/Extensions.cs Updates healthchecks shortlink in playground service defaults comment.
Files not reviewed (2)
  • src/Aspire.Hosting.Azure/Resources/AzureProvisioningStrings.Designer.cs: Language not supported
  • src/Aspire.Hosting/Resources/InteractionStrings.Designer.cs: Language not supported
Comments suppressed due to low confidence (1)

src/Aspire.Cli/Utils/EnvironmentChecker/ContainerRuntimeCheck.cs:1

  • The same https://aka.ms/aspire/containers value is repeated multiple times in this file. Consider introducing a single const string/static readonly field for the containers doc link (and reusing it), which reduces future churn if the shortlink changes again and prevents accidental divergence.
// Licensed to the .NET Foundation under one or more agreements.

Comment thread src/Aspire.Dashboard/Resources/xlf/Columns.zh-Hant.xlf Outdated
Comment on lines +21 to +24
<source>Container runtime was found but appears to be unhealthy. Ensure that it is running.
For more information, see https://aka.ms/dotnet/aspire/container-runtime-unhealthy</source>
For more information, see https://aka.ms/aspire/container-runtime-unhealthy</source>
<target state="translated">找到容器執行階段，但似乎狀況不良。確保它執行中。
如需詳細資訊，請參閱 https://aka.ms/dotnet/aspire/container-runtime-unhealthy</target>
如需詳細資訊，請參閱 https://aka.ms/aspire/container-runtime-unhealthy</target>
Copy link

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The PR description says https://aka.ms/dotnet/aspire/container-runtime-unhealthy was intentionally preserved, but this change updates it to https://aka.ms/aspire/container-runtime-unhealthy (and the same update appears across other Columns.*.xlf files). Either revert these container-runtime-unhealthy updates to keep the dotnet prefix, or update the PR description/scope to reflect that this link is no longer preserved.

Copilot uses AI. Check for mistakes.
Copy link
Copy Markdown
Member Author

@adamint adamint Apr 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@copilot apply changes based on this feedback revert the container-runtime-unhealthy update

Copy link
Copy Markdown
Contributor

Copilot AI Apr 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Reverted in all 13 Columns.*.xlf files — the container-runtime-unhealthy URL now uses https://aka.ms/dotnet/aspire/container-runtime-unhealthy again (commit 98fd278).

Comment thread src/Aspire.Cli/Utils/EnvironmentChecker/ContainerRuntimeCheck.cs
Comment thread src/Aspire.Cli/Utils/EnvironmentChecker/ContainerRuntimeCheck.cs
@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 14, 2026 •
edited
Loading

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/microsoft/aspire/main/eng/scripts/get-aspire-cli-pr.sh | bash -s -- 16176

Or

  • Run remotely in PowerShell:
iex "& { $(irm https://raw.githubusercontent.com/microsoft/aspire/main/eng/scripts/get-aspire-cli-pr.ps1) } 16176"

@adamint adamint enabled auto-merge (squash) April 21, 2026 17:53
@adamint adamint merged commit 569ddf4 into main Apr 23, 2026
821 of 831 checks passed
@github-actions github-actions Bot added this to the 13.3 milestone Apr 23, 2026
@aspire-repo-bot
Copy link
Copy Markdown
Contributor

aspire-repo-bot Bot commented Apr 23, 2026

Docs check: No documentation PR is required for this change.

This PR performs an internal URL normalization — updating aka.ms/dotnet/aspire/* shortlinks to aka.ms/aspire/* across the source code. It introduces no new public APIs, user-facing features, configuration options, behavioral changes, or breaking changes that would require documentation updates on the aspire.dev site.

Generated by PR Documentation Check for issue #16176 · ● 150.3K · ◷

This was referenced Apr 23, 2026
Open
Closed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

Copilot code review Copilot Copilot left review comments

Copilot code review Copilot Copilot left review comments

@davidfowl davidfowl davidfowl approved these changes

@JamesNK JamesNK JamesNK approved these changes

@mitchdenny mitchdenny Awaiting requested review from mitchdenny mitchdenny is a code owner

@karolz-ms karolz-ms Awaiting requested review from karolz-ms karolz-ms is a code owner

@danegsta danegsta Awaiting requested review from danegsta danegsta is a code owner

@eerhardt eerhardt Awaiting requested review from eerhardt eerhardt is a code owner

Assignees

No one assigned

Labels

None yet

Projects

None yet

Milestone

13.3

Development

Successfully merging this pull request may close these issues.

5 participants

@adamint @davidfowl @JamesNK