From ed7ae1f0c769fc93b8fc2454c473c75b080746ce Mon Sep 17 00:00:00 2001 From: "aspire-repo-bot[bot]" <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Date: Wed, 27 May 2026 23:40:54 +0000 Subject: [PATCH 1/2] docs: clarify --channel version-pinning behavior for aspire new When --channel is specified, aspire new now pins the template version to the current installed CLI/SDK version, preventing version mismatches where pre-release channel feeds could otherwise float to a newer template package (e.g. 13.5 preview when the CLI is 13.4). Documents changes from microsoft/aspire#17564. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../src/content/docs/reference/cli/commands/aspire-new.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx b/src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx index 4e015290d..797dcf627 100644 --- a/src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx +++ b/src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx @@ -116,7 +116,7 @@ The following options are available: - **`--channel`** - Channel to use for templates (`stable`, `staging`, `daily`). + Channel to use for templates (`stable`, `staging`, `daily`). When a channel is specified, `aspire new` always selects template packages whose version matches the currently installed CLI/SDK version. This prevents version mismatches that could otherwise occur if the channel feeds a newer pre-release template package — for example, a `13.4` CLI using `--channel daily` will not pull `13.5` preview templates even if the daily feed contains them. - **`--suppress-agent-init`** From 1730e6ecf46ad7171e9446444bf2db41e21853d4 Mon Sep 17 00:00:00 2001 From: David Pine <7679720+IEvangelist@users.noreply.github.com> Date: Fri, 29 May 2026 19:31:47 -0500 Subject: [PATCH 2/2] Address review feedback (1 thread) - Clarify --channel version selection and --version precedence (PRRT_kwDOQK_VN86FQhn6) Verified against microsoft/aspire@565af538808300046a1b7cbe125358661d336a4c on branch release/13.4. Edited per the doc-writer skill. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --- .../src/content/docs/reference/cli/commands/aspire-new.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx b/src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx index 797dcf627..f041e9e53 100644 --- a/src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx +++ b/src/frontend/src/content/docs/reference/cli/commands/aspire-new.mdx @@ -116,7 +116,7 @@ The following options are available: - **`--channel`** - Channel to use for templates (`stable`, `staging`, `daily`). When a channel is specified, `aspire new` always selects template packages whose version matches the currently installed CLI/SDK version. This prevents version mismatches that could otherwise occur if the channel feeds a newer pre-release template package — for example, a `13.4` CLI using `--channel daily` will not pull `13.5` preview templates even if the daily feed contains them. + Channel to use for templates (`stable`, `staging`, `daily`). If you don't specify `--version`, `aspire new` selects a template package from the channel and prefers the version that matches the currently installed CLI/SDK. For explicit pre-release channels, such as `staging` and `daily`, it pins templates to the installed CLI/SDK version when the feed would otherwise select a newer pre-release package. For example, a `13.4` CLI using `--channel daily` won't pull `13.5` preview templates even if the daily feed contains them. If you specify `--version`, that template version is used with the selected channel. - **`--suppress-agent-init`**