Skip to content

[docs] Document Aspire Outage game in the dashboard resource graph - #2066

Closed
aspire-repo-bot[bot] wants to merge 1 commit into
release/17.0from
docs/pr-21693-42121673726-1-c1a9b4b4805cad43
Closed

aspire-repo-bot[bot] wants to merge 1 commit into
release/17.0from
docs/pr-21693-42121673726-1-c1a9b4b4805cad43

Conversation

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#21693

Author: @sebastienros

Target branch: Targeting release/17.0 based on the source PR milestone 17.0 (exact_match).

Why: The PR adds a new user-facing feature on the dashboard resource graph (Aspire Outage game, O shortcut, hard core mode that really stops/starts resources). Triggered signal: dashboard_user_facing_page_changed (Resources.razor, Resources.razor.cs).

Changes (updated page):

  • src/frontend/src/content/docs/dashboard/explore.mdx: new "Play Aspire Outage" section (start button, O / Esc, hard core mode with a caution about resources left stopped) and a "Resource graph" entry in Dashboard shortcuts.

Generated by PR Documentation Check for #21693 · copilot · auto · 20.9 AIC · ⌖ 1.04 AIC · ⊞ 7.4K · ◷

@aspire-repo-bot aspire-repo-bot Bot added the docs-from-code Copilot initiated issue from dotnet/aspire repo label Nov 5, 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 #2066. Use the VS Code button below to open this PR with GitHub Artifacts Explorer and browse the built HTML locally.

VS Code: Open PR #2066 artifacts

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

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

🟡 Changes recommended

The documentation implies the game-over screen identifies stopped resources, but it only reports their count, misleading readers about which resources to restart.

1 open issue
What changed in this PR

Documents Aspire Outage in the dashboard resource graph for Aspire 17.0, covering how to launch the game and the effects of hard core mode on app resources.

Changes:

  • Adds game instructions, controls, and saved preferences.
  • Explains hard core mode and warns about resources remaining stopped.
  • Adds the O shortcut to the dashboard shortcuts reference.
File Description
src/​frontend/​src/​content/​docs/​dashboard/​explore.mdx Adds Aspire Outage guidance, a resource-recovery caution, and the resource graph shortcut.

Review effort: Balanced

On the start screen you can enable **hard core mode**, which is off each time the game opens. In hard core mode, destroying an enemy really stops its resource, and clearing the wave starts the stopped resources again.

<Aside type="caution">
In hard core mode, resources stay stopped if you lose the game or exit it. The game warns about this, and the game over screen lists the resources left stopped. Start them again from the Resources page.
@sebastienros

Copy link
Copy Markdown
Contributor

Closing as a duplicate. An Aspire Outage section with screenshots already landed on release/17.0 in #2144. The parts this PR added on top (the Hard core mode label, which the existing section calls "Hard"; what hard core mode does to resources; and the O shortcut) are folded into #2105.

@sebastienros
Sébastien Ros (sebastienros) deleted the docs/pr-21693-42121673726-1-c1a9b4b4805cad43 branch November 13, 2026 22:47
Sébastien Ros (sebastienros) added a commit that referenced this pull request Nov 13, 2026
- Default order is by type then name; saved order wins; negative values
- Add TypeScript sample and note the ASPIRERESOURCETRAITS001 experimental flag
- Move the section next to Filter and group resources
- Fold in contextual resource actions from #2045
- Fold in Aspire Outage Hard core mode and O shortcut from #2066
Sébastien Ros (sebastienros) added a commit that referenced this pull request Nov 13, 2026
)

Documents changes from microsoft/aspire#21766

Author: ``@sebastienros``

**Target branch:** Targeting `release/17.0` — the latest release branch
on `microsoft/aspire.dev` — because the source PR has no milestone or
`release/*` base ref to derive a more specific target.

**Why:** The source PR replaces `WithDashboardPosition` with the new
`WithDisplayOrder` API (backed by `DisplayOrderAnnotation`), which
controls resource ordering in the dashboard. Triggered signals:
`new_public_type` (`DisplayOrderAnnotation.cs`) and
`dashboard_user_facing_page_changed` (`ResourceOverview.razor`,
`TraceDetail.razor`).

**Changes:** Updated existing page
`src/frontend/src/content/docs/dashboard/explore.mdx` with a "Resource
display order" section describing `WithDisplayOrder` semantics (higher
values first, unset counts as 0) and an example.

> Generated by [PR Documentation
Check](https://github.com/microsoft/aspire/actions/runs/42886203726) for
#21766 · copilot · auto · 31.5 AIC · ⌖ 1.16 AIC · ⊞ 7.4K ·
[◷](https://github.com/search?q=repo%3Amicrosoft%2Faspire.dev+%22gh-aw-workflow-id%3A+pr-docs-check%22&type=pullrequests)

<!-- gh-aw-agentic-workflow: PR Documentation Check, engine: copilot,
model: auto, id: 42886203726, workflow_id: pr-docs-check, run:
https://github.com/microsoft/aspire/actions/runs/42886203726 -->

<!-- gh-aw-workflow-id: pr-docs-check -->
<!-- gh-aw-workflow-call-id: microsoft/aspire/pr-docs-check -->

---

**Review update:** This PR now also consolidates the still-accurate
parts of #2045 and #2066, which edited the same page:
- Corrected `WithDisplayOrder` semantics. The default order is resource
type then name (`ResourcesLayout.razor.cs`). A saved drag order takes
precedence, and negative values sort after unset resources.
- Added a TypeScript sample (`withDisplayOrder` is `[AspireExport]`) and
noted the `ASPIRERESOURCETRAITS001` experimental diagnostic.
- Contextual resource actions (right-click, Context Menu key, Shift+F10)
from #2045.
- The existing Aspire Outage section's mode is labeled **Hard core**,
not **Hard** (`Resources.resx`), and the section now covers what hard
core mode does and the `O` shortcut (from #2066).

---------

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: Sébastien Ros <1165805+sebastienros@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.

2 participants