docs: index Split Payments and the Glossary in llms.txt - #720
Merged
damaz91 merged 2 commits intoAug 13, 2026
Merged
Conversation
damaz91
approved these changes
Aug 13, 2026
ptiper
approved these changes
Aug 13, 2026
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.
Summary
Add
specification/split-payments.mdandspecification/glossary.mdto thellmstxtsectionsallowlist so both reach the publishedllms.txt.Motivation
plugins.llmstxt.sectionsis a strict allowlist. Comparing it againstnav:specification/split-payments.mdis the only one of the 45 nav pagesmissing from it.
git log -Straces this to feat: Introduce the split payments extension #409, which added the nav entrywithout the llmstxt entry; later feature PRs (feat: Add Payment Authentication Actions #458, feat: shopping permalink capability #523) added both, so this
is a lone omission rather than a policy.
specification/glossary.mdis in neither, and has been since docs: add centralized glossary and acronym standards #241 — whilebeing extended by feat: extension-defined Actions primitive #582, feat: reserve the
ucpprotocol namespace, addmap_orderfor registry ordering #657 and feat!: define sale-basis steps for quantities #653. It is reachable only through a proselink at
overview.md.AGENTS.md§2 asks for exactly this: "Sync any MkDocs navigation additions(
mkdocs.yml) with thellmstxtplugin section to ensure that content isdiscoverable and legible by agents."
Confirmed against the built artifact before the change:
dev.ucp.shopping.split_paymentsappears twice inllms-full.txtand zerotimes in
llms.txt; same for the Glossary.Scope
One file, two commits — the split-payments entry is a drift fix under the
AGENTS.md rule, while indexing the Glossary is a new editorial decision, so
they are separable if you want only one.
Two things checked and deliberately left alone:
specification/embedded-protocol.mdappears in both the Checkout and Cartsections, and in neither nav entry. Left as-is: it is a shared transport page
referenced by both capabilities, so the duplication reads as intentional and
keeps each capability index self-contained. It does cost ~30KB of duplicated
content in
llms-full.txt; happy to dedupe in a follow-up if you prefer.nav. Whether an orphan page belongs in sitenavigation is an IA decision rather than an index-drift fix (there is precedent
for llms.txt-only pages:
embedded-protocol.md). Happy to add the nav entrytoo if you want it.
Validation
mkdocs build --strictexit 0 under bothDOCS_MODE=specandDOCS_MODE=root.llms.txtdiff againstmainis exactly the two new lines (86 → 88); thellms-full.txtdiff is purely additive with no other page affected; and theDOCS_MODE=rootoutput is byte-identical tomain.ucp-schema lint source/100 files passed;validate_examples.py302 passed,0 failed. yamllint reports no new diagnostic on the added lines.
Note for release branches:
split-payments.mddoes not exist on any releasebranch, and
sectionsentries pointing at a missing page fail--strict, sothese two lines should not be cherry-picked.