Repository navigation
[docs] Update dashboard resources page docs for simplified dashboard - #2095
Conversation
Frontend HTML artifact readyThe latest frontend build uploaded the This comment updates automatically when a new frontend build artifact is uploaded. |
There was a problem hiding this comment.
🟡 Changes recommended
The review found an issue that should be addressed before approval.
1 open issue
What changed in this PR
Updates the dashboard exploration guide to describe the simplified Resources page introduced by microsoft/aspire#21943.
Changes:
- Describes the combined Type/Source column and URL display.
- Explains the Overview tab, “All resources” selection, muted rows, and shortened ages.
| File | Description |
|---|---|
src/frontend/src/content/docs/dashboard/explore.mdx |
Updates resource column descriptions and dashboard navigation behavior. |
Review effort: Balanced
Maddy Montaquila (maddymontaquila)
left a comment
There was a problem hiding this comment.
Documentation accuracy review
Source: microsoft/aspire release/17.0 at 148071e36dbb16c1cad260dedec2496871b6f49a. Nine claims: 4 verified, 1 verified with nuance, 4 contradicted, 0 unverifiable. The scoped tester exercised /dashboard/explore/#resources-page: 0 critical issues and 4 enumerated warnings (its summary table reports 3). The linked source change was backported to release/17.0 in microsoft/aspire#22186; subsequent changes in microsoft/aspire#22188 and later commits are reflected in the pinned source.
Phase A — Claim verification
Contradicted claims are detailed in the inline comments.
Verified claims and nuance
- The home resource list shows the first URL and a
+Ncontrol for remaining URLs: ResourcesLayout.razor:1057–1063, UrlsColumnDisplay.razor:14–40. - Data pages have no page-level close button back to the table: ResourcesLayout.razor:375–390.
- The first row selects all resources: ResourcesLayout.razor:93–117, ResourcesLayout.razor.cs:2675–2700.
- Ages use short forms: ResourcesLayout.razor.cs:1809–1828.
- Nuance: unavailable resources are muted with a reason, but this depends on the selected data tab; for example, no structured logs matters on the Structured logs tab, and no traces on Traces. Rows are not marked unavailable while the full-page list is shown: ResourcesLayout.razor.cs:2197–2244, ResourcesLayout.razor:1101–1132.
Phase B — Doc-tester results
The tester's report is reproduced below. Its 17.1 knowledge gap is addressed in part by the pinned release/17.0 source above; the exact installed dashboard build used by the tester was not recorded.
Documentation Test Report
Focus Area: PR #2095, dashboard Resources page
Date: 2026-11-16
Tester: doc-tester agent
PR: #2095
Ref: 5e4a3734ff9748e2e248039ec7c4ffb76d0d46a3
Local URL: http://localhost:4321/dashboard/explore/#resources-page (server stopped)
Summary
| Category | Passed | Failed | Warnings |
|---|---|---|---|
| Content accuracy | 6 | 0 | 3 |
| Code examples | N/A | N/A | N/A |
| CLI commands | 2 | 0 | 1 |
| Links | Not tested | — | — |
Critical Issues
None confirmed against the intended product version.
Warnings
Warning 1: Screenshot conflicts with the new description
Location: Resources page
Issue: The screenshot shows the older dashboard layout, without the described Overview tab or All resources row.
Suggestion: Update the screenshot.
Warning 2: Source appears twice
Location: Resources page, resource details list
Issue: The list describes combined Type and Source, then separately lists Source as a column.
Suggestion: Reconcile the two descriptions.
Warning 3: Tested dashboard differs from the described Overview
Location: Resources page
Issue: The installed Aspire 17.0 dashboard opened to the resource list; its Overview tab showed a summary rather than the full table. Both resources also showed “Started 2m ago” despite having the same age. The PR describes an upstream 17.1 change, so these observations cannot establish the intended version’s behavior.
Suggestion: Retest with the matching product build.
Warning 4: Non-interactive starter creation
Issue: The documented starter command prompted for an organization configuration source and failed without interactive input. Declining that source and suppressing agent initialization allowed creation to succeed.
Passed Checks
- The PR page rendered locally.
- Starter resources displayed type, source, a first URL, and a working
+1URL control. - All resources selected both resources.
- Console, Structured logs, Traces, and Metrics tabs opened without a page-level close button.
- A resource without traces showed an explanatory tooltip.
- Short ages appeared in the tested dashboard.
Recommendations
- Update the screenshot and reconcile the Source description.
- Verify Overview, equal-age hiding, and endpoint tooltips using the matching 17.1 product build.
- No product issue was confirmed.
Knowledge Gaps and Blockers
- The matching 17.1 product build was unavailable; endpoint deduplication, localhost tooltips, and equal-age hiding remain unverified.
- No changed links required testing in this scoped run.
- Git is clean, and generated icon changes and
.phase-b-*caches were removed. One ignored test DLL remains locked by MSBuild PID 27012; that potentially shared process was not stopped.
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
The requested documentation corrections have been made and the review threads resolved.
9e9f421
into
release/17.0

Documents changes from microsoft/aspire#21943
Author:
@maddymontaquila(please verify the PR author handle)Targeting
release/17.0, the latest release branch onmicrosoft/aspire.dev, becauserelease/17.1(from the source PR milestone17.1) does not exist there (target_resolution:latest_release_fallback).Why
The source PR changes the dashboard's resources page (signal:
dashboard_user_facing_page_changed): a URL column, a combined Type + Source column, the Overview tab as the full table, an "All resources" row, and muted rows for unavailable data.Changes
src/frontend/src/content/docs/dashboard/explore.mdx(existing page): resource columns, URL column, Overview tab behavior, "All resources" row, muted rows, short ages.Reviewer note: the design-system and accessibility changes are not documented as they are not user-actionable.