Skip to content

fix(skill/sandboxes): use canonical aka.ms install URLs and aca auth login#1732

Open
paulyuk wants to merge 1 commit into
mainfrom
paulyuk/skill-install-canonical-urls
Open

fix(skill/sandboxes): use canonical aka.ms install URLs and aca auth login#1732
paulyuk wants to merge 1 commit into
mainfrom
paulyuk/skill-install-canonical-urls

Conversation

@paulyuk
Copy link
Copy Markdown
Member

@paulyuk paulyuk commented May 29, 2026

Switches plugin/skills/sandboxes/references/install.md to the canonical install surface documented in the ACA Sandboxes ground-truth docs.

Changes

Before After
curl ... raw.githubusercontent.com/.../install.sh | sh curl -fsSL https://aka.ms/aca-cli-install | sh
irm raw.githubusercontent.com/.../install.ps1 | iex irm https://aka.ms/aca-cli-install-ps | iex
az login aca auth login (delegates to az login under the hood)

Both aka.ms shortcuts already redirect to the same install scripts (verified 301 \u2192 raw.githubusercontent.com/.../install.{sh,ps1}), so behavior is identical \u2014 only the user-facing URL changes. aca auth login is a real subcommand on aca 1.0.0-beta.1 (Commands: login | status | help, Log in to Azure (delegates to az login)).

Why

Surfaced by the ACA Sandboxes Vally eval suite (Run 3): pos-install-aca-linux, pos-install-aca-macos, pos-install-aca-windows all failed output-contains graders looking for https://aka.ms/aca-cli-install and aca auth login against the docs ground truth. Eval suite \u2192 coreai-microsoft/adc-devx#214 (EMU).

Risk

Zero. Behavior identical; only the URL surface and auth verb change. az login still works for users who use it directly.

Co-authored-by: Copilot 223556219+Copilot@users.noreply.github.com

…login

Switches plugin/skills/sandboxes/references/install.md to:

- https://aka.ms/aca-cli-install (Linux/macOS) and https://aka.ms/aca-cli-install-ps (Windows) instead of the long raw.githubusercontent.com URLs. Both aka.ms shortcuts already redirect to the same install scripts (verified 200/301), so behaviour is identical but the user-facing URL is what the public ACA Sandboxes docs and ground-truth references use.

- aca auth login as the canonical CLI entry point, with an explicit note that it delegates to az login under the hood. The skill previously told users to run az login directly, which works but bypasses the CLI's own auth verb and is inconsistent with the docs.

Verified locally: aca auth login is a real subcommand on aca 1.0.0-beta.1 (Commands: login | status | help, 'Log in to Azure (delegates to az login)').

Why: surfaced by the ACA Sandboxes Vally eval suite (Run 3) where pos-install-aca-{linux,macos,windows} all failed output-contains for 'https://aka.ms/aca-cli-install' and 'aca auth login' against the docs ground truth.

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