Skip to content

docs: remove the Polygon easy-node guide, unsupported since 3.1 - #22975

Merged
AskAlexSharov merged 1 commit into
mainfrom
docs/main-drop-polygon-guide
Aug 3, 2026
Merged

docs: remove the Polygon easy-node guide, unsupported since 3.1#22975
AskAlexSharov merged 1 commit into
mainfrom
docs/main-drop-polygon-guide

Conversation

@bloxster

@bloxster bloxster commented Aug 3, 2026

Copy link
Copy Markdown
Collaborator

Suggested by @AskAlexSharov. Companion to #22973 (Polygon disk tab) — opened separately because that PR had already entered the merge queue and its branch was frozen.

Why

docs/get-started/easy-nodes/how-to-run-a-polygon-node.md walks the reader through running an Erigon node on Polygon PoS. On main, bor-mainnet has zero occurrences in cmd/utils/flags.go — there is no chain config for that network, so the guide describes something the binary cannot do.

What was removed

  • the guide itself
  • the Polygon card on the Easy Nodes landing page, and Polygon in that page's description frontmatter
  • the "Bad block / Invalid Merkle on Polygon network" entry in help-center/common-errors-and-solutions — its remedy is restarting Bor and Heimdall services, which is Polygon-only, so it goes with the network

What was deliberately kept

  • versioned_docs/version-v3.3 and version-v3.4 keep their copies of the guide. Those series did support Polygon, so the archived pages remain correct — and the archive-link guard expects them.
  • The support statement itself stays in Supported Networks.

The same change is on release/3.5 (#22919) and release/3.6 (#22970), so all three branches drop it together.

Verification

  • npm ci && npm run build — clean, 74 → 73 pages. onBrokenLinks, onBrokenMarkdownLinks and onBrokenAnchors are all throw, so a green build proves no remaining page links to the removed guide.
  • generate-llms.py --check — 4 artifacts match, 73 pages.
  • render-disk-sizes.py --check — unaffected, still matches.
  • python3 -m unittest discover docs/site/scripts — 78 tests, OK.
  • Confirmed no tracked live reference remains outside versioned_docs/.

🤖 Generated with Claude Code

Suggested by @AskAlexSharov, and the companion to the disk-tab removal in
#22973: the guide walks the reader through running an Erigon node on Polygon
PoS, but `bor-mainnet` has no occurrences in cmd/utils/flags.go on this
branch, so there is no chain config for the network it describes.

Removed with every live reference:

- the guide itself
- the Polygon card on the Easy Nodes landing page, and "Polygon" in that
  page's description frontmatter
- the "Bad block / Invalid Merkle on Polygon network" entry in
  help-center/common-errors-and-solutions, whose remedy is restarting Bor and
  Heimdall — Polygon-only, so it goes with the network

versioned_docs is deliberately untouched: v3.3 and v3.4 did support Polygon,
and their archived copies of the guide stay correct for those series.

The support statement itself remains in fundamentals/supported-networks.

Build drops 74 -> 73 pages; `onBrokenLinks` is `throw`, so a green build is
proof nothing still links to the removed page.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@AskAlexSharov
AskAlexSharov added this pull request to the merge queue Aug 3, 2026
Merged via the queue into main with commit 07789c2 Aug 3, 2026
21 checks passed
@AskAlexSharov
AskAlexSharov deleted the docs/main-drop-polygon-guide branch August 3, 2026 17:06
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.

2 participants