Skip to content

[docs] Update dashboard resources page docs for simplified dashboard - #2095

Merged
Maddy Montaquila (maddymontaquila) merged 3 commits into
release/17.0from
docs/pr-21943-42728733909-1-910351611a4599f2
Nov 16, 2026
Merged

Maddy Montaquila (maddymontaquila) merged 3 commits into
release/17.0from
docs/pr-21943-42728733909-1-910351611a4599f2

Conversation

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#21943

Author: @maddymontaquila (please verify the PR author handle)

Targeting release/17.0, the latest release branch on microsoft/aspire.dev, because release/17.1 (from the source PR milestone 17.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

  • Updated 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.

Generated by PR Documentation Check for #21943 · copilot · auto · 27.2 AIC · ⌖ 1.26 AIC · ⊞ 7.4K · ◷

@aspire-repo-bot

Copy link
Copy Markdown
Contributor Author

Frontend HTML artifact ready

The latest frontend build uploaded the frontend-dist artifact for PR #2095. Use the VS Code button below to open this PR with GitHub Artifacts Explorer and browse the built HTML locally.

VS Code: Open PR #2095 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 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

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.

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

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 +1 URL 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

  1. Update the screenshot and reconcile the Source description.
  2. Verify Overview, equal-age hiding, and endpoint tooltips using the matching 17.1 product build.
  3. 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.

Copilot AI added 2 commits November 16, 2026 15:26
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@maddymontaquila
Maddy Montaquila (maddymontaquila) dismissed their stale review November 16, 2026 20:31

The requested documentation corrections have been made and the review threads resolved.

@maddymontaquila
Maddy Montaquila (maddymontaquila) merged commit 9e9f421 into release/17.0 Nov 16, 2026
19 checks passed
@maddymontaquila
Maddy Montaquila (maddymontaquila) deleted the docs/pr-21943-42728733909-1-910351611a4599f2 branch November 16, 2026 20:52
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