Skip to content

[docs] Update aspire ps docs: clarify AppHost-only scope, link to aspire describe#1109

Open
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/aspire-ps-remove-resources-ref-1553033d23878bdf
Open

[docs] Update aspire ps docs: clarify AppHost-only scope, link to aspire describe#1109
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/aspire-ps-remove-resources-ref-1553033d23878bdf

Conversation

@aspire-repo-bot
Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#17479 by @mitchdenny.

Targeting release/13.4 — the latest release branch on microsoft/aspire.dev — because release/13.5 (from the source PR milestone 13.5) does not exist there.

Why this PR is needed

microsoft/aspire#17479 removed the --resources and --include-hidden options from aspire ps, narrowing the command to an AppHost-level listing (analogous to docker ps / kubectl get pods). Users who need per-resource details or continuous streaming should use aspire describe instead.

The aspire ps reference page on the docs site did not previously document these removed options (they were added after the last docs update), but the page lacked:

  • A clear statement that aspire ps only provides an AppHost-level summary, not resource data.
  • A cross-reference to aspire describe for resource inspection and streaming.

What changed

Updated src/frontend/src/content/docs/reference/cli/commands/aspire-ps.mdx:

  • Added a sentence to the Description section clarifying that aspire ps is an AppHost-level summary only, and directing users to aspire describe for per-resource details and streaming.
  • Added aspire describe to the See also section.

Files modified

  • src/frontend/src/content/docs/reference/cli/commands/aspire-ps.mdx — updated (existing page)

Generated by PR Documentation Check for issue #17479 · ● 10.1M ·

…cribe

Documents the removal of the --resources and --include-hidden options
from aspire ps (microsoft/aspire#17479). The command is now strictly an
AppHost-level summary; users who need per-resource details or streaming
should use aspire describe.

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 May 28, 2026
@aspire-repo-bot aspire-repo-bot Bot requested a review from JamesNK May 28, 2026 04:17
@IEvangelist IEvangelist marked this pull request as ready for review May 28, 2026 04:54
@IEvangelist IEvangelist self-requested a review as a code owner May 28, 2026 04:54
Copilot AI review requested due to automatic review settings May 28, 2026 04:54
@IEvangelist IEvangelist requested a review from mitchdenny as a code owner May 28, 2026 04:54
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Documents the AppHost-only scope of aspire ps and cross-references aspire describe for per-resource inspection, reflecting upstream CLI changes in microsoft/aspire#17479.

Changes:

  • Adds a clarifying sentence in the Description section noting aspire ps is AppHost-level only and pointing to aspire describe.
  • Adds aspire describe to the See also section.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

@joperezr joperezr added this to the 13.4 milestone May 28, 2026
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.

2 participants