[docs] Update WithTerminal docs to reflect Terminal-view default for live resources - #1447
Conversation
Documents microsoft/aspire#18867 Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
David Pine (IEvangelist)
left a comment
There was a problem hiding this comment.
Validated against microsoft/aspire#18867. The state-dependent default, selection-time evaluation, and preserved live views are documented accurately.
There was a problem hiding this comment.
Pull request overview
Updates the Aspire AppHost WithTerminal() documentation to match the Aspire dashboard behavior change where terminal-enabled resources default to the Terminal view when the resource is live (Running), and default to Console logs for non-live states.
Changes:
- Documented state-dependent default view selection on the dashboard Console Logs page for terminal-enabled resources.
- Clarified that view selection is evaluated when navigating to a resource and does not auto-switch on later state transitions.
- Retained guidance on manually switching views via the toolbar options (⋯) menu.
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
Documents changes from microsoft/aspire#18867
@IEvangelistTargeting
release/13.5based on the source PR milestone13.5.Why
PR microsoft/aspire#18867 changes the dashboard's Console logs page so that terminal-enabled resources (via
WithTerminal()) default to the Terminal view when the resource is live (stateRunning), instead of always defaulting to Console logs. Non-live states (Waiting/Starting/exited) still default to Console logs. The existing docs page (app-host/with-terminal.mdx) described the old always-Console-logs-first behavior and needed correcting.What changed
src/frontend/src/content/docs/app-host/with-terminal.mdxto describe the new state-dependent default view logic (Terminal when Running; Console logs when Waiting/Starting/Exited/Finished/FailedToStart), and clarified that a later state transition does not auto-switch the view once navigated.Files modified
src/frontend/src/content/docs/app-host/with-terminal.mdxNo new pages were created; this is an update to an existing page.