Skip to content

[docs] Update dashboard persistence docs for flattened directory layout - #1657

Draft
aspire-repo-bot[bot] wants to merge 1 commit into
release/13.6from
docs/pr-20006-34791019647-1-45a31d92456f1f5e
Draft

aspire-repo-bot[bot] wants to merge 1 commit into
release/13.6from
docs/pr-20006-34791019647-1-45a31d92456f1f5e

Conversation

@aspire-repo-bot

Copy link
Copy Markdown
Contributor

Documents changes from microsoft/aspire#20006

@JamesNK

Targeting release/13.6 based on the source PR milestone 13.6.

Why

microsoft/aspire#20006 flattens the dashboard's on-disk persistence layout: Run mode now stores all run snapshots directly under a shared runs directory (adding an empty marker file named with the application's storage key to each run directory so discovery can reject unrelated applications before reading run.json), and Resume mode now stores databases and lock files under a shared resumes directory. Previously both modes nested data under a per-application directory. The dashboard docs described the old per-application-directory layout, so they needed updating to match.

What changed

  • src/frontend/src/content/docs/dashboard/data-persistence.mdx: Updated the "Storage layout" section's Run and Resume mode FileTree diagrams to show the new flattened runs/ and resumes/ directories, described the new application storage-key marker file used for discovery, and updated the "Protect persisted data" section's permissions description to reference the shared runs/resumes directories instead of a per-application directory.
  • src/frontend/src/content/docs/dashboard/security-considerations.mdx: Updated the "Protect persisted data" section's Unix permissions bullet to match the new shared-directory layout, and reworded "Application-name partitioning" to "Application-name scoping" for accuracy.

No new pages were created; both existing pages were updated in place.

Generated by PR Documentation Check for #20006 · auto · 60.2 AIC · ⌖ 11.9 AIC · ⊞ 18.3K ·

Reflects the flattened storage layout from microsoft/aspire#20006: run
snapshots now live directly under a shared runs directory (with an
application storage-key marker file for discovery), and Resume-mode
databases live under a shared resumes directory.

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 Sep 14, 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 #1657. Use the VS Code button below to open this PR with GitHub Artifacts Explorer and browse the built HTML locally.

VS Code: Open PR #1657 artifacts

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

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.

0 participants