Skip to content

Add verified Aspire 17.0 highlights without changing curated sections - #2166

Merged
Mitch Denny (mitchdenny) merged 7 commits into
release/17.0from
mitchdenny-aspire-17-release-notes-7e3
Nov 16, 2026
Merged

Mitch Denny (mitchdenny) merged 7 commits into
release/17.0from
mitchdenny-aspire-17-release-notes-7e3

Conversation

@mitchdenny

@mitchdenny Mitch Denny (mitchdenny) commented Nov 15, 2026 •

Copy link
Copy Markdown
Member

Summary

Replacement draft for closed #2099, starting from the existing release/17.0 page, not abandoned changes. Uses the whatsnew research/authoring/critique/validation lifecycle; the user-selected working branch targets release/17.0, overriding generic skill branching guidance. No site-wide banner/version/data/localization edits.

TestShop dashboard tour: four H3 stops with concise explanations and matching light/dark ThemeImage pairs:

View Captured subject Assets
All resources Resource list, live request activity, latency and slowest endpoints New testshop-all-resources(-light).png, 1280×800
Resource graph Service/infrastructure dependencies Existing testshop-dashboard(-light).png reused byte-identically, 1280×800
Resource details Storefront frontend: status, endpoint, logs and telemetry New testshop-resource(-light).png, 1280×800
Distributed traces One real ten-span waterfall across frontend/catalog/PostgreSQL/basket/Redis New testshop-traces(-light).png, 1280×540 crop from full-height viewport

Real activity: browsed catalog pages, added hoodie and mug, submitted the sample checkout form and verified the cart changed from two items to zero. TestShop's activity generator supplemented user actions. The selected trace is explicitly generator traffic, not misrepresented as the checkout trace. Overview includes actual checkout endpoints. No fabricated telemetry, payment details or external purchase.

Version provenance: product microsoft/aspire release/17.0 at a509f094e0ee87d17dc0e1cc9bca84f7ca2623da, compared with published 13.6.5 at b33d222049f1ecc3bc7257ec07b622fe550b2580. Installed CLI 17.0.0+a509f094e0ee87d17dc0e1cc9bca84f7ca2623da; bundled new dashboard reports 17.0.0. Scoped TestShop copy replaces repository-only references with staging packages whose nuspec commits all match a509f094, preserving actual resource declarations. No 17.1 UI. Dashboard executable SHA-256: 032300cf23b332da62d168e9628e7f48b79ab9bc1b3df2fee06df93a54b75c6f.

All six new PNGs optimized and visually reviewed. Application resources were healthy; genuine missing unused parameters, frontend HTTP-redirect warning and six failed internal event traces remain visible. Sample checkout completed. Banners/toasts dismissed; no exposed secrets. Task-owned apps/browser/containers stopped; unrelated apps and existing documentation preview untouched.

Earlier follow-ups retained: custom CLI H3 with four H4s, minimal examples and site references or permitted TODO complete guides. Exact ASPIRE_INIT_SOURCE_URL repository selection, consent, allowed settings, template inheritance, optional path/ref and refresh documented. Entra links to Eric's complete site guide; no guides changed. Earlier dashboard/CLI/AppHost/integration/deployment additions remain.

Eric's curation unchanged: five original complete blocks remain byte-identical, unique and ordered against docs baseline 681cdfeddfa290dbe94cea0830ec1ea885bf1ed1. New imports stay after the complete protected Upgrade block. Original imports/frontmatter, preservation verifier and curated assets remain untouched. Existing graph pair hashes unchanged.

Protected block Bytes SHA-256
Frontmatter, imports, introduction 832 31ac8676532deafef31c5faaff2708e7aad23cb135f6c1deac0aa1dadd9cce0c
Upgrade 779 982aaf4fae694641d1fddb1116252a4f59774fd5e40d0f3b13cfd26c0b5c892c
Go AppHost 911 0da96321cb1a4e1c9bde7b502b38dee71a94e11a99c628e70392f083a18f4840
Default container images 687 c92445350ad9a562ba7ccec9fb2f7cb3daf899e77e9d42e414a5abf6c960add6
Entire breaking-changes section 4,978 3689f54fbf7828a6cca7cafde9728b7b08ec4e7031ddd678137aaf9122dbc84c

Remaining gaps; not release-complete: three permitted TODO complete guides and illustrative team inputs; release-wide coverage/contributors, migration/diagnostic/image-tag details, data ingestion and CI/build/sign-off. Protected resourceImage, publish date and original summaries unchanged; no date invented. Article artwork is present but resource-card frontmatter gate remains incomplete. Secrets/cloud/team-source scenarios are not fully runtime-certified. No remaining dashboard capture blocker.

Third-party links and affiliations

Originating microsoft/aspire PR links and three exact 17.0 source documents (migration, Web PubSub emulator, Service Bus emulator); Entra uses the site guide. Team repository examples are explicit placeholders. Material affiliation disclosure was not provided. No unrelated third-party sites added.

Validation

  • git diff --check — passed.
  • python3 /Users/midenn/.copilot/session-state/819dd6e8-33ab-4dbb-ae69-455637977e2a/files/verify-preservation.py — passed on final committed tour, all five original blocks exact, unique and ordered; original verifier/baseline unchanged, session-only.
  • From src/frontend: npm exec --yes --package=bun@1.4.3 -- bun x vitest run --config vitest.config.ts tests/unit/whats-new.vitest.test.ts tests/unit/whats-new-sidebar.vitest.test.ts tests/unit/dev-resource-catalog.vitest.test.ts — passed after tour, 29 tests in three suites.
  • node --input-type=module using parseFrontmatter, @mdx-js/mdx.compile, sharp.metadata and SHA-256 — passed, final MDX, four H3 tour stops, four ThemeImage instances/eight matching assets, expected dimensions and unchanged graph hashes. Prior CLI JSON/H4/link checks passed.
  • ASTRO_TELEMETRY_DISABLED=1 npm exec --yes --package=bun@1.4.3 -- bun run dev -- --host 127.0.0.1 --port 4368 — refused, existing same-worktree server registered. Did not force-replace it; reused http://localhost:15623/ on IPv6 loopback.
  • playwright-cli -s=tour17-doc-check run-code — passed, all four images decoded and selected the actual correct asset through both native site themes at 1440px and 390px; expected dimensions and no page/image overflow. Desktop/light/mobile visually inspected. Only task browser closed; existing server untouched.
  • Capture: aspire start --non-interactive --isolated --apphost TestShop/TestShop.AppHost/TestShop.AppHost.csproj --launch-profile http --format Json, aspire wait frontend, aspire wait activity-generator — passed. Actual catalog/cart/sample-checkout UI actions and ten-span propagated service/database trace verified. Task capture tools/apps stopped; original source clone untouched.
  • Earlier independent blind follow-up: 0 critical issues, 2 warnings for placeholders/permitted TODOs. Six site destinations, skills anchor, Entra navigation and original artwork theme/mobile checks passed. Frozen report remains historical, not relabeled as independent review of the later tour. Initial source review: 36 claims; custom follow-up: 18 grouped claims verified at pinned SHA. Tour captions match actual captured UI/state.
  • Matching aspire --version, aspire template source add --help, aspire new --help, aspire agent init --help, aspire init --help, aspire update --help — passed, help-only. Initial Bash completion generation/sourcing — passed; secret help — passed, storage scenario unexecuted.
  • Not run: local bun run build (prohibited), cloud provisioning/deployment, full data ingestion or release sign-off. No twoslash introduced. Unrelated pre-existing icon delta excluded from commits.

Preserve all existing curated sections and add source-pinned release highlights.

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

@mitchdenny Mitch Denny (mitchdenny) left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Validation of draft additions at head 30e1484, targeting release/17.0. Source: microsoft/aspire release/17.0 a509f094e0ee87d17dc0e1cc9bca84f7ca2623da, published baseline v13.6.5 b33d222049f1ecc3bc7257ec07b622fe550b2580. Phase A: 36 product claims verified, 0 contradicted, 0 unverifiable. Phase B: six sections tested, no demonstrated critical issues, five initial warning groups; polish follow-through and execution limits are recorded below. This is a COMMENT, not approval or release sign-off. Protected original content is outside the factual-review scope.

Aspire 17.0 critique and validation

Critique

Major, release-finalization: Research is a bounded draft, not an exhaustive account of 573 commits. Default image updates, matching-release resource artwork, diagnostics, terminal/tray/agent features, and complete contributor enumeration remain unfinished. No release-complete claim.

Major, protected content: Original lede has no 1:1 section summary; publishDate and resourceImage are absent; the original image section does not list the additional product-source tag changes. Preserve rather than fix. Eric's breaking-change summary and subsections remain byte-for-byte unchanged.

Major, teaching follow-through: The first draft linked to an older .NET hosting guide with obsolete publishing limitations and emulator guides without new-feature instructions. Polish replaced these destinations with exact-release source migration/README links, retaining their pinned SHA. Source-blind report remains frozen separately.

Minor, CLI setup: Specify current-shell lifetime for completion and AppHost directory for secret commands. Applied.

Minor, link clarity: Name Entra's external destination as the README on GitHub. Applied.

Standard Result
Separate deployment and integrations Pass
Separate first-party new integrations Pass
No independently released Toolkit features Pass
Accurate positive, impact-first framing Pass for additions
Judicious alerts Pass: no new alerts
AppHost sample language parity N/A: no new AppHost code fences
Section-summary 1:1 mapping Not satisfied in protected introduction; unchanged
Full container-image inventory in article Not satisfied in protected image section; dossier records source diff
Release date Unavailable: v17.0.0 release endpoint 404
Resource artwork Not satisfied; no generic/17.1 artwork substituted
Community attribution Included for authored community features; exhaustive release audit pending
Placeholder/TODO cleanup Pass in additions
Diagnostic-author follow-up Deferred: no diagnostic articles added

Frozen Phase A: claim verification

Product source: microsoft/aspire release/17.0 SHA a509f094e0ee87d17dc0e1cc9bca84f7ca2623da.
Published comparison: v13.6.5 SHA b33d222049f1ecc3bc7257ec07b622fe550b2580.
No fallback to main, 17.1 daily, Community Toolkit, or Azure SDK main.

The following 36 product claims were individually checked against the pinned source. Verdicts: 36 verified, 0 contradicted, 0 unverifiable. Narrative statements and contributor attribution are not included in this product-claim denominator.

ID Normalized claim Pinned evidence
A01 Shared resource pane persists context across telemetry tabs src/Aspire.Dashboard/Components/Layout/ResourcesLayout.razor.cs:866,1094-1106
A02 Pane supports search/filter/multiple selection ResourcesLayout.razor, selection bindings and filter controls
A03 Grouping by tags/resource type/state ResourcesLayout.razor.cs:1361-1430
A04 Metrics display cards with live sparklines src/Aspire.Dashboard/Components/Pages/Metrics.razor:214-271
A05 Instruments can be pinned Metrics.razor.cs:326-333,379-384
A06 Previous experience is conditional and selectable in Settings Components/Dialogs/SettingsDialog.razor.cs:110-122, Components/DashboardExperienceComponents.cs:25
A07 CLI exposes completions script subcommand src/Aspire.Cli/Commands/CompletionsCommand.cs:14-36
A08 Accepted explicit shells are bash/fish/pwsh/zsh src/Aspire.Cli/Completions/CompletionScripts.cs, SupportedShells
A09 Completion script is written to stdout for redirection CompletionsCommand.cs:44-57; exact pinned CLI execution succeeded
A10 Secret commands support environment and -e src/Aspire.Cli/Commands/SecretCommand.cs:16-29
A11 Omitted value opens secret input prompt src/Aspire.Cli/Commands/SecretSetCommand.cs:96-98
A12 --envvar reads a named environment variable SecretSetCommand.cs:26-31,81-92
A13 Noninteractive requires value or environment source SecretSetCommand.cs:57-60
A14 Aspire minimum supported .NET is 10 eng/Versions.props:11-12, diff from 13.6.5; PR #20614
A15 Requirement does not mandate .NET 10 for all orchestrated workloads Separate Go/JavaScript workload hosting remains available; #20614 targets Aspire framework support
A16 Dotnet hosting package now uses stable versioning src/Aspire.Hosting.Dotnet/Aspire.Hosting.Dotnet.csproj:8-10, SuppressFinalPackageVersion removed vs 13.6.5
A17 AddProject is deprecated, retained src/Aspire.Hosting/ProjectResourceBuilderExtensions.cs:71,110,125,383
A18 Entra hosting integration is new compared with baseline New src/Aspire.Hosting.Azure.EntraId/Aspire.Hosting.Azure.EntraId.csproj
A19 Entra package remains preview Same csproj:8, SuppressFinalPackageVersion=true
A20 Entra can provision registrations/service principals EntraIdResourceExtensions.cs:59, provisioning code and pinned README
A21 Existing Entra registrations can be referenced EntraIdResourceExtensions.cs:371,433
A22 Entra references supply identity configuration EntraIdResourceExtensions.cs:54-56, reference callbacks
A23 Referencing Entra does not install authentication middleware EntraIdResourceExtensions.cs:56, README authentication guidance
A24 APIM hosting package is new and preview New csproj, SuppressFinalPackageVersion=true
A25 APIM models APIs/backends/policies src/Aspire.Hosting.Azure.ApiManagement/AzureApiManagementExtensions.cs:180 and AddBackend/policy APIs
A26 OpenAPI can come from file or reachable deployed endpoint Same extensions, WithOpenApiDocument/WithOpenApiEndpoint; ordering at :78-106
A27 APIM is not provisioned in local run Same extensions:109-112, CreateResourceBuilder rather than AddResource/provisioning
A28 Kubernetes hosting packages stable csproj SuppressFinalPackageVersion removed, PR #20936
A29 Some persistent-volume APIs remain experimental KubernetesPersistentVolumeExtensions.cs and AzureKubernetesPersistentVolumeExtensions.cs Experimental(ASPIRECOMPUTE002)
A30 Helm minimum is 4.0.0 src/Aspire.Hosting.Kubernetes/Deployment/HelmVersionValidator.cs, MinimumHelmVersion
A31 Existing AKS environments can be targeted src/Aspire.Hosting.Azure.Kubernetes/AzureKubernetesEnvironmentExtensions.cs:128-149,896-1003
A32 Front Door Private Link supports provisioned ACA and App Service src/Aspire.Hosting.Azure.FrontDoor/AzureFrontDoorPrivateLinkExtensions.cs:90-114
A33 Front Door Private Link API remains experimental Same file:131-132
A34 Private endpoint must be approved before traffic flows Same file:98-100
A35 Web PubSub supports local RunAsEmulator; Service Bus supports SQL resource reuse AzureWebPubSubExtensions.cs:180, AzureServiceBusExtensions.cs:708
A36 Deno hosting APIs lose previous experimental designation DenoHostingExtensions.cs full diff vs 13.6.5, removal of Experimental(ASPIREDENO001)

Cross-reference validation: all 12 current internal targets exist; four pinned source destinations and both README anchors resolve in source; migration URL returns HTTP 200. All added originating PRs were looked up, attribution confirmed, and their labels inspected. No docs-from-code follow-up is required for the authored set.

Frozen Phase B and polish follow-through

Independent report: doc-tester-report.md. Source-blind pass: six sections, eight initial internal links, dark/light desktop/mobile layout, hub discovery passed. Bash completion generation and sourcing executed with 17.0.0+a509f094e0ee87d17dc0e1cc9bca84f7ca2623da. Secret scenario was help-only; no secret storage or cloud deployment executed.

Polish addresses W1 by linking the matching-release migration guide instead of stale site guidance; W2 by linking matching-release emulator READMEs at exact anchors; W3 by explicitly naming GitHub; W4 by specifying current-session completion and AppHost directory. Persistent shell installation remains outside this focused release note and points to originating PR details. W5 is unchanged local /api/live/ 404 context, with no blocking rendering effect.

Fresh validation after all polish: 29 tests across three release metadata/sidebar/catalog suites passed; MDX/frontmatter compilation passed; 12 internal link targets and all pinned source anchors passed; final browser verified all ten H2s and corrected migration/emulator destinations. No new TypeScript/AppHost snippets or twoslash blocks, so twoslash execution is N/A.

Preservation evidence

All five original top-level blocks preserved exactly once, byte-for-byte, in original order:

  • Frontmatter/imports/introduction: 832 bytes, SHA256 31ac8676532deafef31c5faaff2708e7aad23cb135f6c1deac0aa1dadd9cce0c.
  • Upgrade: 779 bytes, SHA256 982aaf4fae694641d1fddb1116252a4f59774fd5e40d0f3b13cfd26c0b5c892c.
  • Go AppHost: 911 bytes, SHA256 0da96321cb1a4e1c9bde7b502b38dee71a94e11a99c628e70392f083a18f4840.
  • Container images: 687 bytes, SHA256 c92445350ad9a562ba7ccec9fb2f7cb3daf899e77e9d42e414a5abf6c960add6.
  • Entire breaking-changes section: 4,978 bytes, SHA256 3689f54fbf7828a6cca7cafde9728b7b08ec4e7031ddd678137aaf9122dbc84c.

Original page SHA256: 963967b38122b2191a808093ea591007d536d9439f55b73dad7c38e5d1a13f20.
Proof compares snapshot and git show 681cdfed:... bytes, then exact block identity, uniqueness, and ordering.

Gate status

Useful validated draft additions; NOT complete research/polish/review modalities. Draft PR must remain draft. Skill release-wide gates for exhaustive coverage, artwork/date, generated ingestion, CI, and blind execution of all scenarios are incomplete. Do not merge, undraft, or claim release-complete.

Phase B — Frozen source-blind doc-tester report

Frozen Phase B documentation test report

Date: 2026-11-15
Tester: Independent, source-blind doc-tester
Draft: http://127.0.0.1:4367/whats-new/aspire-17/
Browser session: release17-blind — closed after testing
Scope: Dashboard updates, CLI updates, AppHost updates, New integrations, Deployment updates, Integration updates.

Independence and limits

Activated doc-tester and playwright-cli. Read the draft and linked local documentation only through playwright-cli. Did not open product source, product clones, implementation/tests, PR #2099, an author's dossier, or any linked GitHub PR/README. Protected Go, Upgrade, Default container image updates, and Breaking changes sections were not evaluated or edited.

No repository code changes, PR comments, local Bun build, global installation, Azure deployment, or cloud provisioning. Browser theme preferences were changed only within the isolated browser context. Generated Bash completion files were removed. No screenshots were needed; observations below use rendered DOM, browser navigation, and terminal output.

This is a frozen browser/user-experience report, not a source-based assertion that product APIs or feature claims are correct.

Summary

Check Result
Six added sections render and have working TOC destinations Passed
Eight new site-relative LearnMore links clicked Passed; all open named documentation pages
Light/dark themes, desktop 1440×1000 and mobile 390×844 Passed layout checks
Hub discoverability and navigation Passed
Documented Bash completion commands, installed 17.0 CLI Executed successfully
Environment-specific secret scenario Not executed; command help checked only
AppHost/integration examples and dashboard feature behavior Not executed
Azure/AKS/Front Door deployment behavior Not executed; unauthorized

Critical issues

None demonstrated. No broken internal LearnMore destinations, missing scoped headings, or failing executed release-note example were observed. Unexecuted product scenarios are not counted as passes.

Warnings

W1 — Path-based AppHost migration needs a publishing caveat

Location: /whats-new/aspire-17/#-apphost-updates → /integrations/frameworks/dotnet/dotnet-host/

Draft: “Use the path-based project model when updating your AppHost.”

Observed follow-through: The linked guide teaches AddDotnetProject / addDotnetProject, but also says:

Automatic project publishing for DotnetProjectResource isn’t currently supported. A plain DotnetProjectResource causes aspire publish and aspire deploy to fail with an actionable error instead of emitting an executable.v0 manifest containing machine-local paths.

It then recommends AddProject<TProject>(...) for referenced C# projects and AddCSharpApp(...) / addCSharpApp(...) for path-based projects requiring standard publishing.

Impact: A reader may treat the release-note migration advice as unconditional and only learn about the deployment trade-off after changing their AppHost. This is a cross-document teaching concern, not a runtime-confirmed failure.

Recommendation: Qualify the new migration advice for apps that publish/deploy, or explicitly direct readers to the guide's publishing limitations before migration.

W2 — Emulator LearnMore pages do not teach the specific announced changes

Location: /whats-new/aspire-17/#-integration-updates

Draft:

Run Azure Web PubSub locally with its emulator using RunAsEmulator.

Reuse a SQL Server resource for the Azure Service Bus emulator instead of creating a separate instance.

See Host Azure Web PubSub, Host Azure Service Bus, and Host Deno apps for configuration examples.

Reproduction: Click the Web PubSub and Service Bus links; read their displayed configuration guidance.

Observed:

  • /integrations/cloud/azure/azure-web-pubsub/azure-web-pubsub-host/ describes Azure provisioning and addAzureWebPubSub, but its displayed guide has no emulator setup section or RunAsEmulator instructions. Its caution says the app must configure an Azure subscription and location.
  • /integrations/cloud/azure/azure-service-bus/azure-service-bus-host/ teaches emulator setup/configuration, including RunAsEmulator, but the displayed content does not explain reuse of an existing SQL Server resource. No WithSqlServer/withSqlServer, shared-SQL, or reuse guidance was found.

Impact: The links are navigationally correct, but a new reader cannot follow them literally to implement these two newly announced local-development features without guessing or opening product material.

Recommendation: Add focused 17.0 examples to these destinations, or link directly to documentation that teaches the announced configuration. Do not send the reader into cloud provisioning to learn an emulator feature.

W3 — Entra ID's guide is an external product README, not a local LearnMore destination

Location: /whats-new/aspire-17/#microsoft-entra-id

Draft: “See the Microsoft Entra ID integration guide for registration, credential, and workload configuration.”

Observed link: https://github.com/microsoft/aspire/blob/a509f094e0ee87d17dc0e1cc9bca84f7ca2623da/src/Aspire.Hosting.Azure.EntraId/README.md

Impact: This is explicitly outside the allowed source-blind test boundary. Availability and teaching quality of that guide remain unverified. The link text does not communicate that it leaves the documentation site.

Recommendation: Label the destination as the integration README on GitHub, or provide a local integration guide. An external README is not itself a broken link; no availability claim is made here.

W4 — CLI snippets need clearer scenario context

Locations: /whats-new/aspire-17/#shell-completion, /whats-new/aspire-17/#environment-specific-secrets

Observed:

  • Bash generation and sourcing work. The displayed “installation details” link goes to a product PR rather than a local shell setup guide. The snippet does not say how to persist completion across future shell sessions.
  • The secret example correctly tells the reader to set DATABASE_PASSWORD, but does not state the AppHost working-directory prerequisite or link to the secret command's setup/context documentation.
  • Installed command help describes --apphost as an AppHost project path or directory to search, and --environment as selecting that AppHost's Aspire secrets file.

Impact: A new reader knows the value source but not where to run the secret command or which AppHost will own the secret. I did not fill that gap by selecting the repository's AppHost or writing into a user's existing secret state.

Recommendation: Link to local completion installation and secret-command guidance. Add “Run from your AppHost directory” or another documented explicit AppHost selection instruction, with an isolated example setup if execution is intended.

W5 — Local environment has live-update console errors

Routes: Release-note page and visited documentation pages.

Observed console evidence:

Failed to load resource: the server responded with a status of 404 (Not Found) @ http://127.0.0.1:4367/api/live/

[live-status] Live API not found (404); live updates disabled until reload.

The WebSocket connection also warned about closing before establishment.

Impact: No blocking effect on the tested content/navigation. Treat this as a local-server limitation, not a release-note content defect. No unrelated infrastructure fix is recommended in this pass.

Passed checks

Headings and TOC

Clicked all six TOC entries at desktop and mobile widths. Each URL hash resolved to the expected rendered H2:

Section Exact route/hash
Dashboard updates /whats-new/aspire-17/#-dashboard-updates
CLI updates /whats-new/aspire-17/#%EF%B8%8F-cli-updates
AppHost updates /whats-new/aspire-17/#-apphost-updates
New integrations /whats-new/aspire-17/#-new-integrations
Deployment updates /whats-new/aspire-17/#-deployment-updates
Integration updates /whats-new/aspire-17/#-integration-updates

The compact “On this page” menu had to be expanded before selecting entries; this is normal disclosure behavior. The CLI hash's encoded variation selector resolves correctly. Scoped subordinate headings render: Shell completion, Environment-specific secrets, Microsoft Entra ID, Azure API Management.

Internal LearnMore navigation

Each link was clicked from the draft, with destination URL and rendered page heading verified:

Link Destination
Host .NET projects /integrations/frameworks/dotnet/dotnet-host/
Azure API Management /integrations/cloud/azure/azure-api-management/azure-api-management-get-started/
Deploy to Kubernetes clusters /deployment/kubernetes/clusters/
Azure Container Apps /deployment/azure/container-apps/
Azure App Service /deployment/azure/app-service/
Host Azure Web PubSub /integrations/cloud/azure/azure-web-pubsub/azure-web-pubsub-host/
Host Azure Service Bus /integrations/cloud/azure/azure-service-bus/azure-service-bus-host/
Host Deno apps /integrations/frameworks/deno/deno-host/

All eight are site-relative, end with /, and resolve without a not-found document. There are no anchor fragments on these eight links.

Rendering and mobile

  • Light and dark selections update data-theme and foreground/background colors.
  • Desktop document width remained 1440px at a 1440px viewport; both new CLI blocks fit their 1036px containers.
  • Mobile document/main widths remained 390px at a 390px viewport in both themes.
  • Mobile CLI blocks stay within 356px containers and scroll horizontally with overflow-x: auto rather than widening the page. Their content scroll widths were 592px and 1004px.
  • All six mobile TOC clicks succeeded with no page-wide horizontal overflow.
  • These are DOM/layout checks, not a screenshot-based aesthetic or full accessibility certification.

Hub discoverability

At /hub/browse/, entering Aspire 17 into “Search resources...” produced two results, including What's new in Aspire 17.0, labeled Release notes. Clicking its card opened /whats-new/aspire-17/ with the correct H1. No release-date or artwork promise was assumed or evaluated.

Teaching strengths

  • Dashboard prose explains the investigation workflow and gives a conditional fallback rather than promising universal availability.
  • Secret prose explicitly distinguishes masked interactive input from non-interactive --envvar/value requirements.
  • AppHost prose distinguishes the AppHost minimum framework requirement from requirements on every orchestrated workload.
  • Entra ID explicitly warns that identity references do not install authentication middleware or secure routes.
  • API Management explicitly explains deployment-only behavior and local aspire run limitations.
  • Deployment prose distinguishes stable packages from experimental APIs, states a Helm minimum, and calls out Private Link approval.
  • Linked Container Apps and App Service guides repeat the Private Link approval requirement.

Exact CLI execution evidence

Available executable: /Users/midenn/.aspire/bin/aspire

aspire --version returned:

17.0.0+a509f094e0ee87d17dc0e1cc9bca84f7ca2623da

No 17.1 or stable 13.6 executable was substituted.

Actually executed, copied literally from the rendered Shell completion snippet, inside .doc-tester-workspace/release17-blind/:

aspire completions script bash > aspire-completion.bash
source ./aspire-completion.bash

Both succeeded. A shell check confirmed _aspire_complete and _aspire_decode_ansi_c functions were registered. This confirms script generation and sourcing, not interactive Tab-completion behavior or Fish/PowerShell/Zsh behavior.

Help-only check, not the scenario: aspire secret set --help succeeded and displayed the documented -e/--environment, --envvar, optional value, and non-interactive options.

Not executed:

aspire secret set Parameters:database-password --environment production --envvar DATABASE_PASSWORD

No isolated AppHost was supplied by the new section, and I did not choose an existing AppHost or mutate user secret state to fill that gap. Masked prompting, environment isolation, actual secret storage, and consuming a stored secret remain untested.

Knowledge gaps and recommendations

  1. AppHost migration/publishing: A reader needs to know which path-based API preserves publishing. This gap was learned from the linked documentation, not product source. Add a caveat/link; do not assume familiarity with the resource models.
  2. Local emulator setup: A reader needs the actual emulator and SQL-reuse calls, prerequisites, and minimal AppHost configuration. I did not infer APIs from prior knowledge. Update the linked guides before treating LearnMore as implementation guidance.
  3. CLI context: A reader needs AppHost selection and persistent shell-completion setup. Command help partially exposes the AppHost requirement; the release-note example does not. Provide local instructional links.
  4. Dashboard operation: Pinning, grouping, shared resource selection, and fallback availability were read but not exercised in a running 17.0 dashboard. No product UX conclusion is asserted.
  5. Entra ID: README reachability, credentials, registration/reference behavior, and consuming authentication configuration remain unverified because following the link would breach the source-blind boundary.
  6. Deployment/integrations: Package availability, AppHost compilation, stable/experimental designations, Helm compatibility, AKS-existing-cluster targeting, Front Door approvals, and emulator runtime behavior require a separately authorized execution/source-validation pass. No Azure deployment was attempted.

Recommended handoff: Address W1–W4 as documentation follow-through improvements. Keep W5 separate as local environment context. Preserve this Phase B report unchanged; it does not authorize edits or certify the unexecuted product scenarios.

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Frontend HTML artifact ready

The latest frontend build uploaded the frontend-dist artifact for PR #2166. Use the VS Code button below to open this PR with GitHub Artifacts Explorer and browse the built HTML locally.

VS Code: Open PR #2166 artifacts

This comment updates automatically when a new frontend build artifact is uploaded.

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

@mitchdenny Mitch Denny (mitchdenny) left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

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

Follow-up validation: CLI sources, Entra guide and TestShop artwork

Source: microsoft/aspire release/17.0 at a509f094e0ee87d17dc0e1cc9bca84f7ca2623da, published13.6.5 comparison b33d222049f1ecc3bc7257ec07b622fe550b2580. Frozen initial36 + follow-up18 grouped claims verified; 0 contradicted/unverifiable. Initial Phase B remains in the prior review. New independent blind Phase B exercised only the follow-up sections: 0 critical issues, 2 warnings (illustrative team inputs and user-permitted TODO complete guides). This is not release-complete sign-off.

Final screenshot revision 6847506b7079d519717581246ff961a348444751: actual pinned17.0 TestShop in both themes, real site theme swap validated,29 targeted tests passed, MDX/assets and unchanged byte-preservation verifier passed. All five original blocks remain byte-identical and ordered; no Eric guides/assets modified. New imports are outside protected blocks. No local site build.

Phase A — Claim verification

Initial frozen36-claim catalog

Product source: microsoft/aspire release/17.0 SHA a509f094e0ee87d17dc0e1cc9bca84f7ca2623da.
Published comparison: v13.6.5 SHA b33d222049f1ecc3bc7257ec07b622fe550b2580.
No fallback to main, 17.1 daily, Community Toolkit, or Azure SDK main.

The following 36 product claims were individually checked against the pinned source. Verdicts: 36 verified, 0 contradicted, 0 unverifiable. Narrative statements and contributor attribution are not included in this product-claim denominator.

ID Normalized claim Pinned evidence
A01 Shared resource pane persists context across telemetry tabs src/Aspire.Dashboard/Components/Layout/ResourcesLayout.razor.cs:866,1094-1106
A02 Pane supports search/filter/multiple selection ResourcesLayout.razor, selection bindings and filter controls
A03 Grouping by tags/resource type/state ResourcesLayout.razor.cs:1361-1430
A04 Metrics display cards with live sparklines src/Aspire.Dashboard/Components/Pages/Metrics.razor:214-271
A05 Instruments can be pinned Metrics.razor.cs:326-333,379-384
A06 Previous experience is conditional and selectable in Settings Components/Dialogs/SettingsDialog.razor.cs:110-122, Components/DashboardExperienceComponents.cs:25
A07 CLI exposes completions script subcommand src/Aspire.Cli/Commands/CompletionsCommand.cs:14-36
A08 Accepted explicit shells are bash/fish/pwsh/zsh src/Aspire.Cli/Completions/CompletionScripts.cs, SupportedShells
A09 Completion script is written to stdout for redirection CompletionsCommand.cs:44-57; exact pinned CLI execution succeeded
A10 Secret commands support environment and -e src/Aspire.Cli/Commands/SecretCommand.cs:16-29
A11 Omitted value opens secret input prompt src/Aspire.Cli/Commands/SecretSetCommand.cs:96-98
A12 --envvar reads a named environment variable SecretSetCommand.cs:26-31,81-92
A13 Noninteractive requires value or environment source SecretSetCommand.cs:57-60
A14 Aspire minimum supported .NET is 10 eng/Versions.props:11-12, diff from 13.6.5; PR #20614
A15 Requirement does not mandate .NET 10 for all orchestrated workloads Separate Go/JavaScript workload hosting remains available; #20614 targets Aspire framework support
A16 Dotnet hosting package now uses stable versioning src/Aspire.Hosting.Dotnet/Aspire.Hosting.Dotnet.csproj:8-10, SuppressFinalPackageVersion removed vs 13.6.5
A17 AddProject is deprecated, retained src/Aspire.Hosting/ProjectResourceBuilderExtensions.cs:71,110,125,383
A18 Entra hosting integration is new compared with baseline New src/Aspire.Hosting.Azure.EntraId/Aspire.Hosting.Azure.EntraId.csproj
A19 Entra package remains preview Same csproj:8, SuppressFinalPackageVersion=true
A20 Entra can provision registrations/service principals EntraIdResourceExtensions.cs:59, provisioning code and pinned README
A21 Existing Entra registrations can be referenced EntraIdResourceExtensions.cs:371,433
A22 Entra references supply identity configuration EntraIdResourceExtensions.cs:54-56, reference callbacks
A23 Referencing Entra does not install authentication middleware EntraIdResourceExtensions.cs:56, README authentication guidance
A24 APIM hosting package is new and preview New csproj, SuppressFinalPackageVersion=true
A25 APIM models APIs/backends/policies src/Aspire.Hosting.Azure.ApiManagement/AzureApiManagementExtensions.cs:180 and AddBackend/policy APIs
A26 OpenAPI can come from file or reachable deployed endpoint Same extensions, WithOpenApiDocument/WithOpenApiEndpoint; ordering at :78-106
A27 APIM is not provisioned in local run Same extensions:109-112, CreateResourceBuilder rather than AddResource/provisioning
A28 Kubernetes hosting packages stable csproj SuppressFinalPackageVersion removed, PR #20936
A29 Some persistent-volume APIs remain experimental KubernetesPersistentVolumeExtensions.cs and AzureKubernetesPersistentVolumeExtensions.cs Experimental(ASPIRECOMPUTE002)
A30 Helm minimum is 4.0.0 src/Aspire.Hosting.Kubernetes/Deployment/HelmVersionValidator.cs, MinimumHelmVersion
A31 Existing AKS environments can be targeted src/Aspire.Hosting.Azure.Kubernetes/AzureKubernetesEnvironmentExtensions.cs:128-149,896-1003
A32 Front Door Private Link supports provisioned ACA and App Service src/Aspire.Hosting.Azure.FrontDoor/AzureFrontDoorPrivateLinkExtensions.cs:90-114
A33 Front Door Private Link API remains experimental Same file:131-132
A34 Private endpoint must be approved before traffic flows Same file:98-100
A35 Web PubSub supports local RunAsEmulator; Service Bus supports SQL resource reuse AzureWebPubSubExtensions.cs:180, AzureServiceBusExtensions.cs:708
A36 Deno hosting APIs lose previous experimental designation DenoHostingExtensions.cs full diff vs 13.6.5, removal of Experimental(ASPIREDENO001)

Cross-reference validation: all 12 current internal targets exist; four pinned source destinations and both README anchors resolve in source; migration URL returns HTTP 200. All added originating PRs were looked up, attribution confirmed, and their labels inspected. No docs-from-code follow-up is required for the authored set.

Frozen18-claim follow-up catalog and evidence

18 grouped follow-up claims verified; 0 contradicted or unverifiable. These extend the frozen initial 36-claim review, not a claim that every release feature is covered. Source paths below are under microsoft/aspire/src/Aspire.Cli at the pinned SHA unless stated otherwise.

ID Claim Evidence
C01 Named template sources are used by aspire new Commands/TemplateManagementCommand.cs, Templating/ConfiguredTemplateSourceService.cs
C02 Source can be an absolute local path, or repository/path/ref Commands/TemplateManagementCommand.cs:30-61, Templating/TemplateSourceConfiguration.cs:99
C03 Template registration is global and asks for trust confirmation Commands/TemplateManagementCommand.cs, matching CLI aspire template source add --help
C04 integrationSources permits named local/feed sources Packaging/IntegrationSourceConfiguration.cs:16-28,151-159
C05 Patterns filter exact IDs, prefixes or all packages IntegrationSourceConfiguration.cs:28,163
C06 Built-in integration discovery remains unless disabled IntegrationSourceConfiguration.cs:20,90-116
C07 skillSources supplies marketplace repositories and plugins Agents/AspireSkills/SkillSource.cs:16,35-44
C08 Skill source defaults, enabled flag and optional ref are supported SkillSource.cs:32-48,102-123
C09 Copilot/Claude marketplaces and OpenCode catalogs are supported SkillSource.cs:18-19,122-123; agent-specific initialization implementations
C10 aspire agent init --skills aspire applies configured enabled sources Commands/AgentInitCommand.cs; matching help and linked skills documentation
C11 ASPIRE_INIT_SOURCE_URL specifies shared source repository CliConfigNames.cs:11, Configuration/ConfigSourceService.cs:160-181
C12 Source acceptance requires consent, accepts true/false override ConfigSourceService.cs:154-221; matching init help
C13 Materialization allows skill/integration settings and records local source binding ConfigSourceService.cs:37,376-402 and saved-source code
C14 Explicit shared source templates are inherited, not materialized ConfigSourceService.cs:314-373
C15 Source path defaults to aspire.config.json, optional ref selects branch/tag/commit CliConfigNames.cs:12-13, ConfigSourceService.cs:181,334,373
C16 aspire update --config-source refreshes adopted configuration Commands/UpdateCommand.cs; matching update help
C17 Entra LearnMore targets Eric's existing canonical complete site guide aspire.dev/integrations/security/microsoft-entra-id/index.mdx, no slug override; local HTTP 200; #2086/#2111 authorship
C18 Screenshot/alt show real TestShop in the 17.0 dashboard testshop-capture-report.md, matching CLI/dashboard binary path and package nuspec commits; actual UI visually reviewed

The four principal source files were added after published 13.6.5: baseline comparison reports 1,468 added lines and no preexisting version of these files. No published 13.6.x backport assumed new.

Phase B — Independent blind revision report (verbatim)

Documentation Test Report

Focus Area: PR2166 follow-up revisions only; blind Phase B.
Date: 2026-11-16 (Australia/Sydney)
Tester: doc-tester with playwright-cli, isolated browser revision17-blind
Served page: http://127.0.0.1:4368/whats-new/aspire-17/
PR ref: Caller-provided current PR2166 working tree; no checkout, source inspection, commit, edit of repository content, push, or build.

Summary

Outcome: 0 critical issues; 2 documentation warnings. Rendering, revised internal links, skills anchor, image loading, genuine theme swapping, and page-width checks passed. CLI help validates command surfaces only: no custom-source scenario was executed end to end.

The frozen initial six-section review was not repeated. Scope was the H3 Custom templates, integrations, and skills, its four H4s, the changed Microsoft Entra ID integration LearnMore destination, and the inserted TestShop image under Dashboard updates. No product-source code or parent's source evidence was consulted.

Category Result
Revised content structure Four H4s and their minimal examples present; trust/replacement/consent notes readable
Code examples Two rendered JSON examples parse successfully; zero scenarios compiled or executed
CLI commands Version and four help commands successful; behavioral execution intentionally excluded
Links Six revised internal destinations return HTTP 200; skills anchor exists
Image/theme Two genuinely different image assets load in matching light/dark themes
Responsive layout Desktop 1440px and mobile 390px have no page horizontal overflow

Routes exercised

All navigation used playwright-cli against the existing local server.

Route Browser result
/whats-new/aspire-17/ Release page renders; scoped sections inspected
/reference/cli/commands/aspire-new/ HTTP 200; “aspire new command”
/integrations/custom-integrations/hosting-integrations/ HTTP 200; “Create custom hosting integrations”
/reference/cli/configuration/#configure-ai-agent-plugins-and-skill-sources HTTP 200; exact heading/anchor exists
/reference/cli/commands/aspire-init/ HTTP 200; “aspire init command”
/reference/cli/commands/aspire-update/ HTTP 200; “aspire update command”
/integrations/security/microsoft-entra-id/ HTTP 200; “Microsoft Entra ID integration”

The custom-skills cross-reference and Entra LearnMore were also clicked from the release page, confirming actual client-side navigation to their correct destinations. The Entra click succeeded; an initial broad h1 inspection hit Astro dev-toolbar headings, so confirmation used main h1 instead. This was a test locator issue, not a site defect.

All scoped internal links are site-relative with trailing slashes before any fragment. The four H4 self-links target existing IDs: custom-templates, custom-integrations, custom-skills, and init-source-mechanism.

Critical Issues

None observed within these revisions. No claim of full runtime feature accuracy or successful end-to-end execution is made.

Warnings

Warning 1: Minimal examples require user-owned illustrative inputs

Location: /whats-new/aspire-17/#custom-templates-integrations-and-skills

The rendered examples use:

  • /absolute/path/to/team-templates — an illustrative directory, not a supplied template collection.
  • ./packages and Team.Hosting.* — a user-populated package directory and illustrative package-name pattern, not a verified published package.
  • example-org/team-skills, marketplace team-skills, plugin platform — illustrative names, not a verified installable marketplace/plugin.
  • https://github.com/example-org/aspire-defaults.git — an illustrative configuration repository, not a runnable supplied source.

The page explicitly says “Replace the path with a directory containing your templates,” “Place your Team.Hosting.* NuGet packages in the packages directory,” and “Replace the repository, marketplace, and plugin names with your own.” It also says “Replace the URL with your configuration repository.”

These caveats are clear and reduce confusion, but the examples are not executable out of the box. No fictional repository was invoked, no plugin installed, no package discovery attempted, and no template source registered globally. Valid JSON parsing and help output do not establish discovery, plugin installation, or configuration adoption success.

Suggestion: Keep the explicit replacement/trust notes; link a complete authoring walkthrough with supplied safe inputs when available.

Warning 2: Three complete guides are still explicitly TODO

Location: Custom templates, Custom integrations, Init source mechanism.

The browser visibly renders:

TODO: Add complete documentation for authoring templates and managing named template sources.

TODO: Add complete documentation for named integration sources and package filtering.

TODO: Add a complete guide to shared configuration sources and their activation environment variables.

These are clear acknowledgments of incompleteness, not broken links. Existing aspire new, hosting-authoring, aspire init, and aspire update destinations load, but they do not make these minimal release-note fragments complete runnable walkthroughs.

Suggestion: Replace TODOs with complete guides covering preparation, adoption, discovery, refresh, and removal, without presenting the current fragments as tested recipes.

Passed Checks

Four H4s and teaching clarity

  1. Custom templates: Local registration command and aspire new are rendered in a named code block; replacement path and global registration/trust implications are stated.
  2. Custom integrations: integrationSources JSON renders and parses; source: "./packages" and patterns: ["Team.Hosting.*"] are readable; package preparation and built-in-source note are visible.
  3. Custom skills: skillSources JSON renders and parses; replacement values and aspire agent init --skills aspire are visible. The linked anchor contains agent-specific fields, OpenCode V1/V2 catalog fields, source defaults, and the caveat that disabling registration does not uninstall previously registered content. This was read as documentation, not independently verified behavior.
  4. Init source mechanism: Environment-variable example and replacement repository note render; consent, explicit accept/decline flags, optional defaults, activation path/ref variables, and refresh command are stated.

TestShop image: actual loading and genuine theme swap

The page uses this descriptive alt:

TestShop running in the Aspire 17.0 dashboard, with its resource list and dependency graph shown side by side.

Visually inspected screenshots show TestShop's resource list at left and dependency graph at right, matching the alt. Theme changes were made through the site's real Dark and Light radio controls, not CSS recoloring or an emulated screenshot.

Theme Actual currentSrc asset encoded in local /_image/ URL Decode
Light testshop-dashboard-light.png complete: true, natural size 1280 × 800
Dark testshop-dashboard.png complete: true, natural size 1280 × 800

Both desktop variants were visually inspected and contain genuinely different dashboard backgrounds. Switching back to Light at 390px restored the light asset; the dark mobile capture uses the dark asset.

At 390 × 844, each image occupied x=16 through x=374, width=358, height=224.5 CSS pixels. The full image fit the page without clipping or horizontal overflow. Screenshot text is naturally small at that scaled width; the descriptive alt still accurately identifies its content.

Visual evidence: revision17-light-desktop.png, revision17-dark-desktop.png, revision17-light-mobile.png, revision17-dark-mobile.png, revision17-custom-desktop.png, and revision17-custom-mobile.png alongside this report.

Desktop/mobile page width

  • Desktop: innerWidth = document.documentElement.scrollWidth = 1440, both dashboard image themes and each revised H4.
  • Mobile: innerWidth = document.documentElement.scrollWidth = 390, both image themes and each revised H4.
  • Mobile code blocks retain contained overflow-x: auto; measured client width 356px, scroll widths 745px (templates), 377px (integrations), 473px (skills), and 880px (init example). This is intentional code-block scrolling, not page horizontal overflow.

Verifiable installed CLI checks

The following commands completed successfully with exit code 0:

Exact command Observed evidence
aspire --version 17.0.0+a509f094e0ee87d17dc0e1cc9bca84f7ca2623da
aspire template source add --help <name>, --path, --repository, --ref; help explicitly describes global configuration and trust confirmation
aspire agent init --help --skills includes aspire; agent IDs include copilot, claude, opencode; project/global scope options
aspire init --help --use-config-source; help says specify false to decline
aspire update --help --config-source and --use-config-source; help describes refresh of saved Git configuration settings

These were help-only checks. They do not verify actual consent prompts, Boolean parsing during execution, environment-variable activation, copying/merging settings, package filters, template discovery, agent downloads, or refresh behavior.

Recommendations

  1. No critical rendering/link fix is indicated by this focused run.
  2. Preserve the explicit trust and replacement caveats.
  3. Prioritize the three TODO guides; supply complete prerequisites and reproducible examples.
  4. Keep the genuine theme-specific TestShop assets and descriptive alt.
  5. Parent should combine these blind findings with its separate source-claims review before PR publication.

Knowledge Gaps and Unexecuted Scenarios

What a new user still needs: A real unpacked template collection and authoring steps; real hosting NuGet packages and discovery/filter setup; an accessible team marketplace/plugin or OpenCode catalog; and a real shared configuration repository with adoption/refresh lifecycle instructions.

Source of knowledge: Only rendered documentation and installed CLI help. No intrinsic/product-source knowledge was used to fill these gaps or turn illustrative names into working fixtures.

User impact: Readers without existing team assets cannot complete these examples literally. The TODO labels and replacement notes accurately signal this, but do not supply those assets or missing guides.

Unexecuted: Template registration/creation, NuGet discovery, plugin/catalog installation, config-source adoption/refresh and consent, activation environment variables, Entra setup, and running TestShop or another AppHost. No secrets were created.

Environment observation: The local site's console reported a 404 for /api/live/; scoped pages and both images loaded normally. This is not attributed to the follow-up changes or promoted to a PR critical issue.

Cleanup and Isolation

Only browser revision17-blind was closed. Parent's server was left running and untouched. No extra application, build, source checkout, global source registration, or PR publication occurred. The report and its screenshots are the retained deliverables.

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

Copy link
Copy Markdown
Member Author

Custom CLI example revision

The template subsection now teaches one-off aspire new --template-repository using the real https://github.com/Azure/aspire-templates repository, followed by forking/customization and --template-repository-ref custom-starter, then persistent aspire template source add azure --repository ....

The fork owner and branch are explicitly illustrative replacements. Ref semantics permit branch, tag or full commit SHA; absent a ref, remote HEAD is used. One-off --template-path and persistent --path select a repository-relative directory. Persistent source command still includes trust-confirmation guidance.

The integration example now uses the explicitly illustrative NuGet service index https://nuget.example.com/v3/index.json, preserving Team.Hosting.* filtering. Init-source URL now uses example-org/aspire-init.git, without naming-convention prose. Skill example and other release-note content remain unchanged.

Evidence

  • Installed matching CLI: 17.0.0+a509f094e0ee87d17dc0e1cc9bca84f7ca2623da.
  • aspire new --help: exact --template-repository, --template-repository-ref, --template-path; remote HEAD default and full-SHA semantics.
  • aspire template source add --help: exact --repository, --path, --ref, global storage and trust confirmation.
  • Pinned product src/Aspire.Cli/Commands/NewCommand.cs:65-71,589-609: option definitions, ref requires repository, default repository template path ".".
  • src/Aspire.Cli/Templating/TemplateEngineFactory.cs:140-183: ref resolution, SHA-keyed checkout, repository-relative template paths.
  • src/Aspire.Cli/Packaging/IntegrationSourceConfiguration.cs:16-28,151-159: named NuGet URL source and package patterns supported.
  • GitHub API confirms Azure repository exists, default branch main; its README lists aspire-azure-starter. Actual templates/aspire-azure-starter/.template.config/template.json confirms a valid unpacked template manifest. Repository is live input, not a claim that its future contents are pinned to this release.

Checks

  • Existing preservation verifier: all five original protected blocks exact, unique and ordered; no hash changed.
  • git diff --check: passed.
  • MDX compilation, Bash syntax checks for all revised shell fences, JSON parse and requested teaching order: passed.
  • Targeted metadata/sidebar suites: 5 tests passed.
  • Existing same-worktree preview /whats-new/aspire-17/: HTTP 200 after revision.
  • No assets, Eric guides, protected original blocks or unrelated icon delta changed.

No example private feed or fork was contacted. No global template source registered, app generated, plugin installed or cloud deployment performed. Help/source/manifest checks are not claimed as end-to-end template execution. No local site build.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@mitchdenny
Mitch Denny (mitchdenny) marked this pull request as ready for review November 16, 2026 04:29
Copilot AI balanced review requested due to automatic review settings November 16, 2026 04:29

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

The release notes incorrectly document tag support for ASPIRE_INIT_SOURCE_REF and direct readers to the Toolkit Deno integration rather than the core Deno APIs.

2 open issues
What changed in this PR

Expands the Aspire 17.0 release-note draft with additional feature highlights while preserving the existing curated sections.

Changes:

  • Adds a four-part TestShop dashboard tour with paired light and dark screenshots.
  • Documents CLI completion, environment-specific secrets, and custom template, integration, skill, and configuration sources.
  • Adds AppHost migration, new integration, Kubernetes, and Azure deployment highlights with supporting references.
File Description
src/​frontend/​src/​content/​docs/​whats-new/​aspire-17.mdx Expands the release notes with the dashboard tour and feature guidance, leaving protected content unchanged.

Review effort: Balanced

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

Mitch Denny (mitchdenny) commented Nov 16, 2026 •

Copy link
Copy Markdown
Member Author

Addressed both factual findings in b8a93e6: the init-source selector now documents branches/full commit SHAs only, and the Deno link targets the pinned core integration README. Original curated blocks remain byte-for-byte unchanged.

🤖 AI-authored reply via Agency Finish PR.

@mitchdenny
Mitch Denny (mitchdenny) merged commit 40a3e01 into release/17.0 Nov 16, 2026
17 checks passed
@mitchdenny
Mitch Denny (mitchdenny) deleted the mitchdenny-aspire-17-release-notes-7e3 branch November 16, 2026 09:29
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.

2 participants