Skip to content

[v1.x] docs: publish llms.txt and markdown renditions of the docs#3029

Merged
maxisbey merged 3 commits into
v1.xfrom
llms-txt-v1x
Jun 30, 2026
Merged

[v1.x] docs: publish llms.txt and markdown renditions of the docs#3029
maxisbey merged 3 commits into
v1.xfrom
llms-txt-v1x

docs: tighten llms_txt failure modes and name embedded snippet sources

a950dcb
Select commit
Loading
Failed to load commit list.
Claude / Claude Code Review completed Jun 30, 2026 in 15m 50s

Code review found 1 potential issue

Found 5 candidates, confirmed 1. See review comments for details.

Details

Severity Count
🔴 Important 0
🟡 Nit 1
🟣 Pre-existing 0
Severity File:Line Issue
🟡 Nit mkdocs.yml:117-118 Hook source published as static site asset

Annotations

Check warning on line 118 in mkdocs.yml

See this annotation in the file changed.

@claude claude / Claude Code Review

Hook source published as static site asset

The hook source `docs/hooks/llms_txt.py` lives inside the default `docs_dir`, and since `mkdocs.yml` sets no `exclude_docs`, MkDocs copies it verbatim into the built site, publishing it at `/hooks/llms_txt.py` as a stray static asset. Harmless, but easy to avoid by adding `exclude_docs: hooks/` or moving the hook outside `docs/` — note the same layout exists on main from #3024, so any cleanup should land on both branches to preserve parity.