Commit 0b922a7
Broaden llms.txt and llms-full.txt to index all public sections (DOCS-98) (#3708)
## What and why
`layouts/index.txt` renders `llms.txt`, the index an AI crawler reads to
discover Chainguard docs. It ranged over only four hardcoded sections --
`chainguard`, `open-source`, `software-security`, `compliance` -- so
every page outside them was invisible to those crawlers. That silently
dropped the largest section on the site (`platform`, 300+ pages),
`get-started`, and the root-level MCP server and Developer Resources
pages. Adding a new section later would reopen the same gap without
anyone noticing.
Fixes DOCS-98.
## Changes
- **`layouts/index.txt`** -- range over every section with `GroupBy
"Section"` instead of naming four, so new sections are indexed
automatically. Root-level pages group under a "General Resources"
heading.
- **Exclusion filter** -- skip any page the site already hides, via
`seo.robots: noindex` or `sitemap_exclude: true`. This keeps `llms.txt`
consistent with the site's own indexing signals.
- **`layouts/index.fulltxt.txt`** (renders `llms-full.txt`) -- apply the
identical section loop and exclusion filter so the two templates stay in
lockstep for future edits. Also fixes a latent bug: a two-variable
`GroupBy` range printed numeric section headers instead of names.
- **`content/vulnerabilities/index.md`** -- mark the legacy 2020
"Vulnerability Information" page `sitemap_exclude: true`, dropping it
from the sitemap and both AI indexes.
## Verification
Built locally with the vendored Hugo and inspected the generated
`public/`:
- `llms.txt`: eight section headings including Platform, Get Started,
the MCP server, and Developer Resources; `noindex` and `sitemap_exclude`
pages absent.
- `llms-full.txt`: same coverage and exclusions; section headers now
show names, not numbers.
- `sitemap.xml`: the legacy vulnerabilities page absent.
## Notes
`contributors/` does not appear in either index -- those are
author-profile `_index.md` section pages, not `RegularPages`. DOCS-101
tracks removing that section entirely.
---
Created in collaboration with Claude Code running Claude Opus 4.8 on
2026-08-05.
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>1 parent 48ec902 commit 0b922a7
3 files changed
Lines changed: 36 additions & 31 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
2 | 2 | | |
3 | 3 | | |
4 | 4 | | |
5 | | - | |
| 5 | + | |
6 | 6 | | |
7 | 7 | | |
8 | 8 | | |
9 | 9 | | |
| 10 | + | |
10 | 11 | | |
11 | | - | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
8 | 8 | | |
9 | 9 | | |
10 | 10 | | |
11 | | - | |
12 | | - | |
13 | | - | |
14 | | - | |
15 | | - | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
| 19 | + | |
| 20 | + | |
| 21 | + | |
| 22 | + | |
| 23 | + | |
| 24 | + | |
| 25 | + | |
16 | 26 | | |
17 | 27 | | |
18 | 28 | | |
| |||
26 | 36 | | |
27 | 37 | | |
28 | 38 | | |
29 | | - | |
| 39 | + | |
| 40 | + | |
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
1 | 1 | | |
2 | 2 | | |
3 | 3 | | |
4 | | - | |
5 | | - | |
6 | | - | |
7 | | - | |
8 | | - | |
9 | | - | |
10 | | - | |
11 | | - | |
12 | | - | |
13 | | - | |
| 4 | + | |
| 5 | + | |
| 6 | + | |
| 7 | + | |
| 8 | + | |
| 9 | + | |
| 10 | + | |
| 11 | + | |
| 12 | + | |
| 13 | + | |
| 14 | + | |
| 15 | + | |
| 16 | + | |
| 17 | + | |
| 18 | + | |
14 | 19 | | |
15 | 20 | | |
16 | | - | |
17 | | - | |
18 | | - | |
19 | | - | |
20 | | - | |
21 | | - | |
22 | | - | |
23 | | - | |
24 | | - | |
25 | | - | |
26 | | - | |
27 | | - | |
28 | | - | |
| 21 | + | |
| 22 | + | |
29 | 23 | | |
30 | 24 | | |
31 | 25 | | |
| |||
0 commit comments