Skip to content

Update from code changes: describe llms.txt v2 scoped indexes - #7092

Closed
mintlify-development[bot] wants to merge 1 commit into
mainfrom
mintlify/23e39cf4
Closed

Update from code changes: describe llms.txt v2 scoped indexes#7092
mintlify-development[bot] wants to merge 1 commit into
mainfrom
mintlify/23e39cf4

Conversation

@mintlify-development

@mintlify-development mintlify-development Bot commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

Summary

Update the llms.txt docs to describe the new v2 layout: scoped child indexes served under /_llms/<scope>.md, and the ## Indexes directory that the root llms.txt now emits for large sites.

Changes

  • Correct the 100k-character note so it reflects that Mintlify splits the index into scoped files instead of dropping tail pages.
  • Add a new "Scoped indexes for large sites" section explaining the /_llms/<scope>.md path, how scopes are chosen (navigation subtree, then URL path segment for large flat sections), the root ## Indexes directory with breadcrumbs and unique page counts, and the recursive-follow instruction for AI tools.
  • Include an example of the rendered ## Indexes section.
  • Mirror the same updates in es/, fr/, and zh/ translations.

Context

Follows mintlify/mint#10207, #10264, #10329, #10366 and mintlify/server#7654, which introduced the v2 planner/renderer, URL-segment grouping, scoped index route, and the root Indexes directory.


Note

Low Risk
Documentation-only changes to llms.txt guides; no runtime, auth, or data-handling code is modified.

Overview
Updates the llms.txt documentation (and es, fr, zh locales) to match the v2 index layout for large sites.

The 100k-character note now states that Mintlify splits oversized indexes into scoped child files at /_llms/<scope>.md so no pages are dropped, and that the cap applies to any single index file, not only the root.

A new Scoped indexes for large sites section documents how scopes are chosen (navigation subtrees first, then URL path segments for large flat sections), the root ## Indexes directory with breadcrumbs, page counts, and recursive-follow instructions for AI tools, plus an example block. Reverse-proxy guidance for /_llms/* was already present and remains in place after the new section.

Reviewed by Cursor Bugbot for commit 89062ee. Bugbot is set up for automated code reviews on this repo. Configure here.

@mintlify

mintlify Bot commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
mintlify 🟢 Ready View Preview Aug 25, 2026, 5:53 PM

@mintlify

mintlify Bot commented Aug 25, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
tomee 🟡 Building Aug 25, 2026, 5:51 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

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