Add an agent-facing llms.txt directive to page HTML - #2741
Merged
Conversation
- Gated on the site publishing llms.txt (LLMS output format on the current language's home page), so sites that don't opt in are byte-identical - Hidden from visual and assistive presentation (visually-hidden + aria-hidden, no focusable content); agents converting HTML to text read it ahead of any navigation - Fixture tests pin both gate sides, position, and the per-page Markdown pointer (verified red-first with the partial unwired)
- The fr home's front-matter outputs override lacked LLMS, so fr pages had no index for the new directive to point at - Scorecard: 88 (B) -> 96 (A); the directive check passes on all sampled pages and the markdown-undiscoverable diagnostic clears
- Adversarial-review round: assertions now pin the hidden div's markup (a11y attributes) and cover the blog baseof; docs note that custom baseof overrides must call the partial, and the Markdown pointer line is per-page conditional
- data-pagefind-ignore keeps the hidden text out of consumer-site search indexes (Pagefind indexes the whole body by default and honors neither aria-hidden nor visually-hidden); inert for sites without it - Tests: an HTML-only fixture page pins the conditional Markdown pointer the docs describe
The override's only effect was to lag the site config's home outputs (how fr lost LLMS in the first place); removing it lets the base config apply and prevents the next drift.
- The Discovery bullet had outgrown the Features list; Features now links it like the other feature sections - llms.txt is a per-language index (e.g. /fr/llms.txt), not one site-root file - Per-shortcode customization links this site's readfile.markdown.md as a worked example
chalin
marked this pull request as ready for review
August 26, 2026 00:37
chalin
added a commit
to chalin/docsy
that referenced
this pull request
Aug 27, 2026
… nav-page anchor - Release post: new NEW section for the in-body agent directive, Release-summary line, skim-list entry, and sanity-check item; applies-if action for sites overriding baseof templates, delegating details to the agent-support docs. - Changelog: Other-changes line citing the google#2614 arc. - navigation.md: point the docs-section-landing-pages ref at adding-content, where the anchor actually resolves.
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
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.
Uh oh!
There was an error while loading. Please reload this page.