Add llms.txt and Markdown pages for coding agents - #689
Merged
Conversation
GitBook served /llms.txt and a Markdown twin of every page. Both were lost in the HonKit migration and return 404 today. Check in llms.txt by hand, with sections mirroring SUMMARY.md, and copy the Markdown sources into the build so that appending .md to a page URL returns its source. Page sources are unchanged. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Signed-off-by: Shizuo Fujita <fujita@clear-code.com>
✅ Deploy Preview for fluentd-docs ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
kenhys
approved these changes
Sep 7, 2026
kenhys
left a comment
kenhys
left a comment
Contributor
There was a problem hiding this comment.
There is a concern about out-of-date without syncing SUMMARY.md, but it is a good step.
validator warns duplicated-link-text, but its section is different.
npx @bridgetoagent-com/llms-txt-validator ./llms.txt
Need to install the following packages:
@bridgetoagent-com/llms-txt-validator@0.1.0
Ok to proceed? (y) y
Source: ./llms.txt
STATUS: pass
Sections: 22 Links: 209 Errors: 0 Warnings: 0 Info: 15
--- INFO (15) ---
[duplicate-link-text] line 103: Link text "Overview" appears multiple times (first seen on line 21).
[duplicate-link-text] line 129: Link text "forward" appears multiple times (first seen on line 111).
[duplicate-link-text] line 130: Link text "http" appears multiple times (first seen on line 115).
[duplicate-link-text] line 131: Link text "exec" appears multiple times (first seen on line 117).
[duplicate-link-text] line 156: Link text "stdout" appears multiple times (first seen on line 137).
[duplicate-link-text] line 166: Link text "syslog" appears multiple times (first seen on line 116).
[duplicate-link-text] line 179: Link text "json" appears multiple times (first seen on line 170).
[duplicate-link-text] line 180: Link text "ltsv" appears multiple times (first seen on line 167).
[duplicate-link-text] line 181: Link text "csv" appears multiple times (first seen on line 168).
[duplicate-link-text] line 182: Link text "msgpack" appears multiple times (first seen on line 171).
[duplicate-link-text] line 185: Link text "stdout" appears multiple times (first seen on line 137).
[duplicate-link-text] line 186: Link text "tsv" appears multiple times (first seen on line 169).
[duplicate-link-text] line 192: Link text "file" appears multiple times (first seen on line 128).
[duplicate-link-text] line 204: Link text "file" appears multiple times (first seen on line 128).
[duplicate-link-text] line 210: Link text "local" appears multiple times (first seen on line 198).
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.
Coding agents such as Claude Code and Cursor write Fluentd configuration files, and they need this site as a primary source. When the site was hosted on GitBook,
https://docs.fluentd.org/llms.txtand a Markdown twin of every page (the page URL with.mdappended) were served automatically. Both were lost in the move to HonKit and return 404 today.llms.txtis checked in at the repository root and maintained by hand. Its sections mirrorSUMMARY.md, so adding a page means adding one line.Ref. https://llmstxt.org/