Skip to content

[docs] Document standalone Native AOT TerminalHost executable - #1866

Draft
aspire-repo-bot[bot] wants to merge 1 commit into
release/17.0from
docs/pr-20775-38037626285-1-c92440091f28361c
Draft

aspire-repo-bot[bot] wants to merge 1 commit into
release/17.0from
docs/pr-20775-38037626285-1-c92440091f28361c

Conversation

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#20775

@mitchdenny

Why

This PR is needed because microsoft/aspire#20775 ships TerminalHost — the process backing [resource terminals]((aspire.dev/redacted) — as a standalone, self-contained Native AOT executable (terminalhost/Aspire.TerminalHost[.exe]) in CLI bundles, instead of running inside the managed aspire-managed process. Although the public WithTerminal() API is unchanged, this is a user-facing architectural change (confirmed by the PR body's "User-facing usage" section) and a target-framework change (src/Aspire.TerminalHost/Aspire.TerminalHost.csproj now targets net11.0 with PublishAot=true), which were the signals that triggered this automated docs check:

  • pr_body_has_user_facing_section — the PR body has an explicit "User-facing usage" heading.
  • pr_body_has_cli_flag_mention — the body documents CLI/build flag usage for repository developers.
  • target_framework_changed — Aspire.TerminalHost.csproj's TargetFramework changed and PublishAot was added.

What changed

Targeting release/17.0 based on the source PR milestone 17.0.

Added a new "🖥️ TerminalHost ships as a standalone Native AOT executable" section to src/frontend/src/content/docs/whats-new/aspire-17.mdx (the in-progress Aspire 17.0 release notes), covering:

  • The move from the managed aspire-managed process to the standalone terminalhost/Aspire.TerminalHost[.exe] Native AOT executable shipped in CLI bundles.
  • That the existing WithTerminal() API is unchanged, with the same example from the source PR description.
  • The aspire-managed terminalhost compatibility shim that forwards to the native executable for older/unrecognized Hosting versions.
  • Links back to the source PR and to the repository development notes in docs/specs/with-terminal.md for contributors who need to rebuild the framework-dependent relay locally.

Files modified

  • src/frontend/src/content/docs/whats-new/aspire-17.mdx (updated)

No new pages were created; this is an addition to the existing in-progress release-notes page for Aspire 17.0.

Generated by PR Documentation Check for #20775 · copilot · auto · 91.8 AIC · ⌖ 13.6 AIC · ⊞ 20.4K · ◷

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@aspire-repo-bot aspire-repo-bot Bot added the docs-from-code Copilot initiated issue from dotnet/aspire repo label Oct 10, 2026
@aspire-repo-bot

Copy link
Copy Markdown
Contributor Author

Frontend HTML artifact ready

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

VS Code: Open PR #1866 artifacts

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

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

Labels

docs-from-code Copilot initiated issue from dotnet/aspire repo

Projects

None yet

Development

Successfully merging this pull request may close these issues.

0 participants