Skip to content

[docs] Add --include-hidden option docs to describe, logs, and export commands#723

Merged
JamesNK merged 2 commits intorelease/13.3from
docs/cli-include-hidden-option-df51004bcc12cc5f
Apr 16, 2026
Merged

[docs] Add --include-hidden option docs to describe, logs, and export commands#723
JamesNK merged 2 commits intorelease/13.3from
docs/cli-include-hidden-option-df51004bcc12cc5f

Conversation

@aspire-repo-bot
Copy link
Copy Markdown

Documents changes from microsoft/aspire#16146 by @JamesNK.

Why this PR is needed

The Aspire CLI describe, logs, and export commands now hide resources marked as hidden by default (consistent with how the Aspire Dashboard displays them). A new --include-hidden option lets users explicitly reveal hidden resources. The existing documentation did not mention this behavior or the new option.

Changes summary

  • aspire-describe.mdx: Updated description to mention hidden resources are excluded by default; added --include-hidden option to the Options section; added an example.
  • aspire-logs.mdx: Updated description to mention hidden resources are excluded by default; added --include-hidden option to the Options section; added an example.
  • aspire-export.mdx: Updated description to mention hidden resources are excluded by default; added --include-hidden option to the Options section; added an example.
  • includes/option-include-hidden.md (new): Shared include file for the --include-hidden option, reused across all three command pages.

Files modified

  • src/frontend/src/content/docs/reference/cli/commands/aspire-describe.mdx — updated
  • src/frontend/src/content/docs/reference/cli/commands/aspire-logs.mdx — updated
  • src/frontend/src/content/docs/reference/cli/commands/aspire-export.mdx — updated
  • src/frontend/src/content/docs/reference/cli/includes/option-include-hidden.mdnew

Note

This is a draft PR and needs human review before merging.

Generated by PR Documentation Check for issue #16146 · ● 1.8M ·

@davidfowl
Copy link
Copy Markdown
Contributor

This needs to go into the 13.3 branch

Comment thread src/frontend/src/content/docs/reference/cli/commands/aspire-describe.mdx Outdated
@JamesNK JamesNK changed the base branch from main to release/13.3 April 16, 2026 07:53
@JamesNK JamesNK force-pushed the docs/cli-include-hidden-option-df51004bcc12cc5f branch from e466dab to 3cd7aae Compare April 16, 2026 07:54
@JamesNK
Copy link
Copy Markdown
Member

JamesNK commented Apr 16, 2026

@copilot Only the last commit, 3cd7aae, should be in this PR.

Copy link
Copy Markdown
Contributor

Copilot AI commented Apr 16, 2026

@copilot Only the last commit, 3cd7aae, should be in this PR.

I attempted to rebase the branch onto release/13.3 with only the single docs commit, but the report_progress tool rebases onto the remote branch on push failure, which restores the old history. A force push is needed to clean up the branch — a maintainer will need to do this manually (e.g., git rebase --onto origin/release/13.3 3cd7aae~1 docs/cli-include-hidden-option-df51004bcc12cc5f && git push --force).

This needs to go into the 13.3 branch

The PR base is already set to release/13.3. The extra commits from main in the branch need a force push to clean up — see my reply to @JamesNK's comment above.

Copilot AI requested a review from JamesNK April 16, 2026 08:02
… docs

The describe, logs, and export commands now hide resources marked as
hidden by default, with a new --include-hidden option to reveal them.
Update the three command reference pages and add a shared include file
for the new option.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@JamesNK JamesNK force-pushed the docs/cli-include-hidden-option-df51004bcc12cc5f branch from 75fd8b1 to e6ae9d0 Compare April 16, 2026 08:40
Comment thread src/frontend/src/content/docs/reference/cli/commands/aspire-describe.mdx Outdated
@JamesNK JamesNK marked this pull request as ready for review April 16, 2026 08:41
@JamesNK JamesNK merged commit c6f7f4b into release/13.3 Apr 16, 2026
1 check passed
@JamesNK JamesNK deleted the docs/cli-include-hidden-option-df51004bcc12cc5f branch April 16, 2026 08:42
Copilot AI pushed a commit that referenced this pull request Apr 16, 2026
… commands (#723)

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: James Newton-King <james@newtonking.com>
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
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.

3 participants