afdocs: bump to 0.19, migrate config, refresh scorecard - #2740
Merged
Conversation
…corecard - llms-txt-directive -> llms-txt-directive-html + llms-txt-directive-md - llms-txt-freshness -> llms-txt-coverage, run as informational (thresholds 0) since the site's llms.txt is deliberately curated; exclude test fixtures and taxonomy pages from the denominator - re-enable content-start-position (measurement now strips script/style) - re-enable markdown-content-parity with theme-chrome parityExclusions - deterministic sampling for a reproducible committed scorecard - regenerate the published scorecard (afdocs 0.19.0)
12 tasks
chalin
marked this pull request as ready for review
August 25, 2026 14:31
chalin
changed the title
- readfile without code=true Markdown-renders the artifact inside the fence (injected headings/paragraphs, visible on the live page); the code=true form emits it verbatim - deterministic sampling stabilizes the sampled page set and scores, not the artifact bytes (timestamp changes per run)
- Hugo re-indents multiline shortcode output to the call site's list depth, and inside pre that renders as a 2-space prefix on every line; hoisting the details block out of the list removes it - afdocs pads stdout with leading/trailing blank lines; the awk filter drops the edges (interior blank runs untouched)
- The theme's readfile shortcode has only an HTML template, so the markdown output format inherits Chroma markup; a site-local readfile.markdown.md variant emits the file raw, fenced when code=true, keeping the agent-facing variant presentation-free - Review feedback: drop the unnecessary commas in the two new sentences
- Fence-content equality to the committed artifact is stronger than a byte golden of the page (also catches indent and edge-blank regressions) without churning on unrelated page edits - Verified red-first: with the readfile.markdown.md variant removed, only the fence assertion fails; existing goldens stay green, so they never protected this contract
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
npm auditclean.