Skip to content

[docs] Document aspire render debug command and links scenario#970

Closed
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/render-command-links-scenario-17106-21880785006d29d7
Closed

[docs] Document aspire render debug command and links scenario#970
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.4from
docs/render-command-links-scenario-17106-21880785006d29d7

Conversation

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#17106

Author: @JamesNK

Target branch

Targeting release/13.4 based on the source PR milestone 13.4 (exact match on microsoft/aspire.dev).

Why this PR is needed

microsoft/aspire#17106 modified src/Aspire.Cli/Commands/RenderCommand.cs (triggering cli_command_file_changed) and includes a ### User-facing usage section and --scenario links flag mention (pr_body_has_user_facing_section, pr_body_has_cli_flag_mention). The aspire render command had no prior documentation on aspire.dev.

The change adds a links scenario to the hidden, debug-only aspire render command. This scenario allows CLI contributors to smoke test terminal hyperlink rendering — both MarkupHelpers.SafeLink (clickable URLs) and MarkupHelpers.SafeFileLink (clickable file-system paths, including paths with spaces).

Documentation changes

  • New page: src/frontend/src/content/docs/reference/cli/commands/aspire-render.mdx
    • Documents the hidden aspire render debug command with a prominent caution note that it is for CLI contributors/maintainers only
    • Lists all available scenarios including the new links scenario
    • Shows example output for the links scenario
  • Updated: src/frontend/src/content/docs/whats-new/aspire-13-4.mdx
    • Adds a bullet noting the new links scenario for the aspire render debug command

Note

The aspire render command is hidden from end users and only available in debug builds. The SME reviewer should confirm whether this reference page is appropriate for the public docs site, or whether it should be closed as an internal-only change.

Generated by PR Documentation Check for issue #17106 · ● 19.9M ·

…oft/aspire#17106)

Add reference documentation for the hidden aspire render debug command and
document the new 'links' scenario added in microsoft/aspire#17106, which
allows CLI contributors to smoke test terminal hyperlink rendering
(SafeLink and SafeFileLink) without needing a full AppHost.

Also add a brief mention of the links scenario to the What's new in Aspire
13.4 release notes.

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 15, 2026
@aspire-repo-bot
aspire-repo-bot Bot requested a review from davidfowl May 15, 2026 03:50
@davidfowl davidfowl closed this May 15, 2026
@IEvangelist
IEvangelist requested review from JamesNK and removed request for davidfowl July 12, 2026 05:50
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.

1 participant