DOCS-1430 - Improve LLM agent discoverability via head tag#6381
Merged
DOCS-1430 - Improve LLM agent discoverability via head tag#6381
Conversation
…nriched llms.txt Agents don't know our llms.txt exists unless we tell them on every page. This adds a lightweight agent directive (blockquote before the h1) on all doc pages pointing to llms.txt, a <link rel="help"> tag in the HTML head for machine discovery, and rewrites llms.txt from 6 entry points to a structured index of ~140 pages across all doc sections. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
kimsauce
changed the title
…nto llm-agent-discoverability
Changes after merging main: - Change <link rel="help"> to <link rel="llms-txt"> for better semantic clarity - Simplify llms.txt: reduce from 140 entries to ~30 high-value pages - Remove redundant text and focus on essential navigation - Update last modified date Note: Removed src/theme/DocItem/Layout component (top-of-page directive) - this approach was too intrusive for human readers. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
kimsauce
commented
Apr 17, 2026
kimsauce
requested review from
JV0812,
amee-sumo,
jpipkin1 and
mafsumo
as code owners
kimsauce
changed the title
jpipkin1
approved these changes
Apr 17, 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
2 participants
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.
Purpose of this pull request
Improve LLM agent discoverability via a
<link rel="llms-txt">tag and enriched llms.txt.Adds a
<link rel="llms-txt">tag to the HTML head for machine discovery, and rewrites llms.txt from 6 entry points to a curated index of ~40 pages organized by doc section.Select the type of change
Ticket (if applicable)
https://sumologic.atlassian.net/browse/DOCS-1430