Skip to content

[r3.4] docs: regenerate llms.txt after sync-modes update#21074

Merged
bloxster merged 5 commits into
release/3.4from
docs/fix-llms-r34
May 11, 2026
Merged

[r3.4] docs: regenerate llms.txt after sync-modes update#21074
bloxster merged 5 commits into
release/3.4from
docs/fix-llms-r34

Conversation

@bloxster

@bloxster bloxster commented May 9, 2026

Copy link
Copy Markdown
Collaborator

Summary

The Deploy Docs CI was failing on release/3.4 (run #25594249089) because the llms.txt artifacts were out of date.

Root cause: The w19 maintenance PR (#21018) updated the sync-modes.md description to add "blocks" mode, but the llms.txt files were not regenerated. When the llms generator PR (#20993) merged, CI ran generate-llms.py --check and found the committed files did not match the generator output.

Fix: Regenerated all four artifacts (llms.txt, llms-full.txt, docs/site/static/llms.txt, docs/site/static/llms-full.txt) by running python3 docs/site/scripts/generate-llms.py.

Only change is one line in the Sync Modes description:

- Full, minimal, and archive sync...
+ Full, minimal, blocks, and archive sync...

Sync-modes description added 'blocks' mode in the w19 maintenance PR (#21018).
Regenerated all four llms artifact files so the CI check passes.
@bloxster

bloxster commented May 9, 2026

Copy link
Copy Markdown
Collaborator Author

@copilot review

Copilot AI commented May 9, 2026

Copy link
Copy Markdown
Contributor

@copilot review

Reviewed. I rechecked the failing Deploy Docs run on release/3.4 (run 25594249089) and confirmed the failure was the stale llms artifacts check. On this PR branch, local validation now passes (generate-llms.py --check and docs script unit tests), and existing PR CI jobs are green. Covered by commit 1bf2583.

@bloxster bloxster added the docs label May 9, 2026
@bloxster bloxster merged commit 889c81e into release/3.4 May 11, 2026
22 checks passed
@bloxster bloxster deleted the docs/fix-llms-r34 branch May 11, 2026 10:52
pull Bot pushed a commit to Dustin4444/erigon that referenced this pull request May 13, 2026
## Summary

Brings the full `docs/site/` Docusaurus tree into `main`, incorporating
all documentation improvements developed against `release/3.4`.

**Scope:** `docs/site/**` + root `llms.txt` / `llms-full.txt` + removal
of superseded `docs/gitbook/` and `docs/gitbook-help/`. No changes to
Go, proto, or any non-docs source files.

### Included — merged to release/3.4

| PR | What |
|----|------|
| [erigontech#20883](erigontech#20883) | Docusaurus
v3 migration — full `docs/site/` tree, Docusaurus config, versioned v3.3
snapshot |
| [erigontech#20263](erigontech#20263) /
[erigontech#20264](erigontech#20264) | All v3.3
docs ported; branch/versioning convention established |
| [erigontech#20978](erigontech#20978) | Mobile
footer fix, SEO meta tags, OG image |
| [erigontech#20991](erigontech#20991) | Self-host
brand fonts (remove Google Fonts / CDN) |
| [erigontech#21000](erigontech#21000) | `llms.txt`
/ `llms-full.txt` generator script + root artifacts |
| [erigontech#21018](erigontech#21018) | May 2026
w19 maintenance — stale flags, broken links, accuracy fixes |
| [erigontech#21045](erigontech#21045) | CI:
docs-only path filter (skip Go jobs, run docs-site build) |
| [erigontech#21063](erigontech#21063) | `trace`
response fields reference + sync-monitoring guidance |
| [erigontech#21074](erigontech#21074) | Regenerate
`llms.txt` after sync-modes update |
| [erigontech#20997](erigontech#20997) | Brand font
consistency fix, installation page UX |

### Included — pending review on release/3.4

| PR | What |
|----|------|
| [erigontech#21030](erigontech#21030) | Automated
disk size pipeline: `update-disk-sizes.py`, `disk-sizes.json`,
`hardware-requirements.mdx` JSX fix, `generate-llms.py` `—` fallback,
unit tests |
| [erigontech#21129](erigontech#21129) | May 2026
w20 maintenance — `--caplin.nat`, `--caplin.columns-keep-slots`, RPC
subscription defaults, `nat.md` Caplin section, log.dir.verbosity
default |

### What changes on `main`

- `docs/site/` added (full Docusaurus tree, current v3.4 + frozen v3.3
snapshot)
- `docs/gitbook/` and `docs/gitbook-help/` removed (superseded by
Docusaurus)
- Root `llms.txt` and `llms-full.txt` updated to Docusaurus-generated
versions

> ⚠️ This PR does **not** remove `docs/gitbook/` yet — that cleanup will
be a separate commit once this PR is reviewed and approved.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Bloxster <bloxster@proton.me>
Co-authored-by: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-authored-by: lupin012 <58134934+lupin012@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants