Skip to content

docs: regenerate docs surface inventory after Mermaid fixes - #53

Merged
dasiths merged 1 commit into
mainfrom
fix/docs-inventory-mermaid
Oct 1, 2026
Merged

dasiths merged 1 commit into
mainfrom
fix/docs-inventory-mermaid

Conversation

@dasiths

@dasiths dasiths commented Oct 1, 2026

Copy link
Copy Markdown
Collaborator

Problem

#52 fixed the Mermaid diagrams but was merged before CI finished. Its build failed on SnippetCompilationTests.Documentation_FrozenSurface:

Documentation inventory is stale; regenerate only after reviewing changed surfaces.

That test compares SHA-256 hashes of the docs against .agent/plans/2026-09-11-aauth-v11-spec-migration/docs-surface-map.md, so main now fails it too.

Fix

Regenerated the map with AAUTH_UPDATE_DOCS_INVENTORY=1. The diff contains only hash updates: one row for each of the 8 Markdown files edited in #52, and one for each of the 9 Mermaid diagrams in them.

Validation

dotnet test tests/AAuth.Tests --filter "FullyQualifiedName~SnippetCompilationTests|FullyQualifiedName~DocumentationLinkTests": 108 passed, run without the env var.

Refresh SHA-256 hashes in docs-surface-map.md for the Markdown files and
Mermaid fences changed in the previous commit, so
SnippetCompilationTests.Documentation_FrozenSurface passes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@dasiths
dasiths merged commit 9cd494e into main Oct 1, 2026
2 checks passed
@dasiths
dasiths deleted the fix/docs-inventory-mermaid branch October 1, 2026 14:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant