Rebuild docs from scratch: orchestrator, delegator, and governance docs under /network#941
Open
adamsoffer wants to merge 4 commits into
Open
Rebuild docs from scratch: orchestrator, delegator, and governance docs under /network#941adamsoffer wants to merge 4 commits into
adamsoffer wants to merge 4 commits into
Conversation
Replaces the starter scaffold with the revamped supply-side docs: content sourced from the v2 docs, heavily simplified, and organized with the Diátaxis framework (tutorials / how-to guides / explanation / reference) — 27 pages under /network so a future /build (developer) section can be added without breaking URLs. Root redirects to /network. Highlights: - Reference values verified on-chain (1 Jul 2026): voting period is 10 rounds; treasury cut is paused at the 750k LPT ceiling (reads 0); full Controller-resolved contract address table. - Guides across the operator lifecycle: setup, activation, batch and real-time AI (Cascade), pricing (with worked wei/pixel math), and monitoring; delegator guides from acquiring LPT to governance voting and LIP/treasury proposals. - Official Livepeer branding (wordmark, favicon, brand greens) sized to match livepeer.org. - CI workflow validates navigation and internal links on every PR. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
adamsoffer
changed the title
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this PR does
This is a rebuild of the docs from scratch. New information architecture, every page rewritten (content sourced from the existing docs), scoped to the supply side of the network — orchestrators, delegators, and governance/treasury. A few hundred pages come down to 27 focused ones, with deprecated products and unused features (i.e. Livepeer Studio) dropped entirely.
Preview: https://livepeerfoundation-d4522ba3.mintlify.site/network
What's covered
Organized with the Diátaxis framework — each sidebar group serves one reader need:
Reference values verified on-chain
Reference pages carry a "Last verified" date, with values read directly from the contracts on Arbitrum One (
eth_call) rather than copied forward — unbonding period, active-set size, governance thresholds, voting period, treasury cut state, and the full Controller-resolved contract address table with Arbiscan links and no-trust verification steps. Reviewers may want to double-check the stated values against current chain state before merge.URL structure
Everything lives under
/network(from the folder structure, not nav chrome), anticipating the supply/demand split: when the developer platform ships, a/buildsection can be added without moving or breaking a single/networkURL. The root (/) redirects to/networkuntil then, and builder-curious visitors are routed to Discord in the meantime.Repo hygiene
docs-v3free of the media history onmain..github/workflows/docs-checks.yml) validates navigation integrity and internal links on every PR (npm run checklocally).Run locally
npm install && npm run dev🤖 Generated with Claude Code