Improve docs agent readiness - #1961
Draft
joshuablum wants to merge 7 commits into
Draft
Conversation
…ended to link anchors
joshuablum
marked this pull request as draft
August 10, 2026 15:15
jackmcdade
self-requested a review
August 10, 2026 15:15
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.
Our docs currently don't score that high on Cloudflare's https://isitagentready.com and there is a lot of room for improvement. We already serve pages as markdown when appending
.mdto a URL (basic right now and some undiscoverable) and also have allms.txtfile in place (misses a few things). Those can be improved as well as a lot of other changes and improvements (e.g. much more in-depthrobots.txtfile). This PR implements several recommendations and best practices from https://isitagentready.com, https://blog.cloudflare.com/agent-readiness/, and https://blog.cloudflare.com/aeo/.Discoverability
robots.txtis now a route instead of a two line static file. It has aSitemap:directive (there wasn't one), Content Signals declaringsearch=yes, ai-input=yes, ai-train=yes, and explicit groups for 12 named AI crawlers.sitemap.xml. It opened by fetching and entry ID (6aa5449b...) which doesn't exist anymore.Content accessibility
llms.txtwent from 128 to 613 entries. It only walked one level deep, so nested pages like/getting-started/installing/laravelwere dropped and the ~460 reference entries (tags, modifiers, fieldtypes, variables) weren't in there at all. An agent reading it couldn't discover any of it./index.md. None before.<link rel="alternate" type="text/markdown">, plusrel="canonical"and arobotstag withmax-snippet:-1so answer engines can quote a full passage./search-resultsisnoindex.Meta descriptions
introordescription, like the modifiers, variables, orresource API pages. They were emitting empty meta descriptions, empty Open Graph tags and empty
llms.txtentries.intro->description-> first paragraph of the body) that strips code fences,::tabs,:::tipblocks and inline markdown. It's a computedvalue so one implementation covers all templates and also the
llms.txt.Two other bugs fixed
(#update-scripts)became(#update-scripts.md). The.mdnow goes before the fragment.llms.txt.digitalocean.mdispublished: falsebut was included in the file. Now correctly filter the entries.