Skip to content

docs: add component hubs for op-node, op-proposer, op-challenger, op-deployer (A4 batch 2) - #21917

Merged
sbvegan merged 5 commits into
developfrom
docs-improver/a4-hubs-batch2
Jul 22, 2026
Merged

sbvegan merged 5 commits into
developfrom
docs-improver/a4-hubs-batch2

Conversation

@claude

@claude claude Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Requested by Matthew Cruz · Slack thread

Tracks ethereum-optimism/solutions#969

What

Second batch of Option A slice 4 (component hubs) from the canonical-homes plan (projects/docs-improver/plans/option-a-canonical-homes.md in ethereum-optimism/solutions), following the skeleton template and Stack Components section merged in #21865:

  • op-node hub (op-stack/components/op-node.mdx): the rollup node's one identity page, linking the Docker/source tutorials, consensus-client and blobs guides, the flag and JSON-RPC references, releases, source, and the rollup-node + derivation specs.
  • op-proposer hub (op-stack/components/op-proposer.mdx): links the spin-up tutorial, permissionless-migration and Kona-proofs guides, the proposer configuration reference, releases, source, and the proposals + withdrawals specs.
  • op-challenger hub (op-stack/components/op-challenger.mdx): links the spin-up tutorial, configuration guide, the run-a-fault-proof-challenger solution guide, prestate tutorial, the new generated challenger configuration reference (docs: roll the flag-reference generator out to op-node, op-proposer, op-challenger, op-conductor #21873), releases, source, and the honest-challenger + fault-dispute-game specs.
  • op-deployer hub (op-stack/components/op-deployer.mdx): routes into the existing canonical OP Deployer doc set under the Chain Operators tab (the one component whose README already declares its docs source of truth).
  • Index: the four rows flip from "Planned" to linked hubs.
  • docs.json: new "Derivation & Execution" and "Deployment & Infrastructure" subgroups; op-proposer and op-challenger join "Settlement & Proofs".

All four hubs follow the template's exact six-H2 skeleton and the content guide's dual-sourcing ban: identity prose plus links, no restated reference content.

Source citations

Every factual claim was verified against monorepo source at develop (op-node/README.md, op-proposer/README.md, op-challenger/README.md, op-deployer/README.md, the linked docs pages' own content) and spec paths against the specs repo at main (protocol/rollup-node.md, protocol/derivation.md, protocol/proposals.md, protocol/withdrawals.md, fault-proof/stage-one/honest-challenger-fdg.md, fault-proof/stage-one/fault-dispute-game.md, protocol/configurability.md). The branch is synced with develop past #21873 (generated flag references): the op-challenger hub links the new challenger-configuration reference, and the op-node hub's flag-reference description matches the reworked generated op-node-config page; both describe the generated tables only as those pages present them.

Nav / redirects (serialized docs.json lane)

One docs.json hunk (two new subgroups + two added entries in Stack Components), merged cleanly with #21873's docs.json change after sync. No pages moved or deleted, so no redirects. Checks run locally after the sync: nav validator OK, redirect lint OK, link-policy lint clean against baseline with specs-mirror resolution, docs.json parses.

Reviewer checklist

🤖 Drafted by the docs-improver agent — review before merge.

🤖 Generated with Claude Code


Generated by Claude Code

claude added 4 commits July 21, 2026 00:09
…deployer (A4 batch 2)

Second reviewed batch of Stack Components hub pages, following the merged
hub skeleton template (Overview / Get started / How-tos / Configuration &
flags reference / Releases / Source & spec links). Hubs are thin
identity-and-links pages per the content guide's dual-sourcing ban.

- New hubs: op-stack/components/{op-node,op-proposer,op-challenger,op-deployer}.mdx
- Index: flip the four rows from Planned to linked hubs
- docs.json: new Derivation & Execution and Deployment & Infrastructure
  subgroups; op-proposer and op-challenger join Settlement & Proofs

Tracks ethereum-optimism/solutions#969

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EBBBR8m2V8LjzMvuG7Go2L
Review-derived style convention for this batch: no em dashes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EBBBR8m2V8LjzMvuG7Go2L
)

The op-challenger hub's flags slot now links the new generated
challenger-configuration reference instead of the no-reference-yet
fallback wording, and the op-node hub's flag-reference description
matches the reworked generated op-node-config page.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@claude
claude Bot requested a review from a team as a code owner July 21, 2026 00:20
@claude claude Bot added docs-improver Opened by the docs-improver agent size:M docs-improver size band documentation labels Jul 21, 2026
@mintlify

mintlify Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Optimism-Docs 🟢 Ready View Preview Jul 21, 2026, 12:21 AM

@mintlify

mintlify Bot commented Jul 21, 2026

Copy link
Copy Markdown
Contributor

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
Optimism-Docs 🟡 Building – Jul 21, 2026, 12:20 AM

Apply review suggestions on PR #21917: call op-challenger the dispute
game challenge service, and describe op-deployer as a deployment tool
only, with its upgrade and manage commands marked deprecated and linked
to the deprecation notice.

Co-Authored-By: Claude <noreply@anthropic.com>
@sbvegan
sbvegan added this pull request to the merge queue Jul 22, 2026
Merged via the queue into develop with commit 12b6e15 Jul 22, 2026
18 checks passed
@sbvegan
sbvegan deleted the docs-improver/a4-hubs-batch2 branch July 22, 2026 19:02
claude Bot pushed a commit that referenced this pull request Jul 22, 2026
Semantic-union resolutions:
- docs.json: keep develop's op-node entry in the Stack Components
  "Derivation & Execution" subgroup and add A5's kona-node entry beside it
- op-stack/components/index.mdx: keep develop's op-node Hub link (#21917)
  and A5's kona-node Hub link in the components table

Co-Authored-By: Claude <noreply@anthropic.com>
ClaytonNorthey92 pushed a commit to hemilabs/optimism that referenced this pull request Sep 19, 2026
…deployer (A4 batch 2) (ethereum-optimism#21917)

Co-authored-by: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs-improver Opened by the docs-improver agent documentation size:M docs-improver size band

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants