Skip to content

docs: prose audit — tradenames + code-fence types + Prune Modes rename [main]#21496

Merged
AskAlexSharov merged 1 commit into
mainfrom
docs/prose-audit-main-2026-05-28
May 29, 2026
Merged

docs: prose audit — tradenames + code-fence types + Prune Modes rename [main]#21496
AskAlexSharov merged 1 commit into
mainfrom
docs/prose-audit-main-2026-05-28

Conversation

@bloxster
Copy link
Copy Markdown
Collaborator

Summary

Forward-port of erigontech/erigon#21451 (against release/3.4) onto main. Same content fixes plus the Sync Modes → Prune Modes rename, applied to main's docs/ tree.

Squashed into a single commit because the original branch's commit-by-commit history wouldn't cherry-pick cleanly (10 commits on a different base).

Changes

  • §7.1 Tradename casing in prose — Docker, Linux, Sentry, TxPool, Downloader, RPC Daemon, MacOS → macOS, …
  • §7.4 Terminologyexecution clientexecution layer client
  • §7.3 Code-fence types — untyped ``````text (Prism crashes on auto-detect on some snippets)
  • Rename: docs/site/docs/fundamentals/sync-modes.mdprune-modes.md (title + H1 + ~16 internal link updates across docs/ and help-center/)
  • llms.txt + llms-full.txt regenerated (both static/ and root copies)

Forward-port nits

Main was slightly behind release/3.4 on two files; the 3-way merge picked up the newer release/3.4 content in addition to the prose-audit changes:

  • default-ports.md: eth/68 + eth/69 row split, --p2p.allowed-ports flag entry, reworded "Typically" prose
  • multiple-instances.md: 30303/30304 port range in the port table

These are minor content updates that should already be in main, not new content invented by this PR.

Verification

  • npm run build passes with onBrokenLinks/onBrokenAnchors: 'throw'
  • llms regeneration matches the updated docs

Merge order

This is the main-targeted twin of #21451. Either can merge first; they touch disjoint branches.

🤖 Generated with Claude Code

…e [main]

Forward-port of #21451 (against release/3.4) onto main. Bundles the
full prose-audit + sync-modes-to-prune-modes rename into a single
commit since the original branch is on a different base.

Content changes (vs main):
- §7.1 tradename casing in prose (Docker, Linux, Sentry, TxPool,
  Downloader, RPC Daemon, MacOS → macOS, …)
- §7.4 terminology (execution client → execution layer client)
- §7.3 code-fence types — untyped ``` → ```text (Prism crashes on
  auto-detect on some snippets)
- Renamed docs/site/docs/fundamentals/sync-modes.md → prune-modes.md
  with title + H1 + ~16 internal link updates across docs/ and
  help-center/

Also pulled in (minor content drift that release/3.4 had but main
did not, picked up during 3-way merge conflict resolution):
- default-ports.md: eth/68 + eth/69 row split + --p2p.allowed-ports
  flag entry + reworded "Typically" prose
- multiple-instances.md: 30303/30304 port range in the port table

llms.txt + llms-full.txt (both static/ and root) regenerated.

Build: `npm run build` passes with onBrokenLinks/onBrokenAnchors: 'throw'.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@AskAlexSharov AskAlexSharov added this pull request to the merge queue May 29, 2026
Merged via the queue into main with commit aa3a86d May 29, 2026
40 checks passed
@AskAlexSharov AskAlexSharov deleted the docs/prose-audit-main-2026-05-28 branch May 29, 2026 07:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants