feat: stValuts doc center rework - #954
Merged
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Reworks the stVaults documentation into a role-based center while retaining the previous center as legacy.
Changes:
- Adds guides for vault owners, builders, node operators, and custodians.
- Introduces an interactive product-guide selector and detailed operational references.
- Expands Dashboard role-management documentation.
Reviewed changes
Copilot reviewed 72 out of 72 changed files in this pull request and generated 7 comments.
Show a summary per file
| File | Description |
|---|---|
run-on-lido/stvaults/index.md |
Marks the previous center as legacy. |
run-on-lido/stvaults-new/index.md |
Adds the new documentation hub. |
run-on-lido/stvaults-new/faq.md |
Adds an FAQ placeholder. |
run-on-lido/stvaults-new/builders/index.md |
Adds the builders landing page. |
run-on-lido/stvaults-new/builders/product-guides/index.mdx |
Adds the interactive guide selector. |
run-on-lido/stvaults-new/builders/product-guides/guides.md |
Adds an unlisted guide catalog. |
run-on-lido/stvaults-new/builders/product-guides/basic-stvaults/index.md |
Adds the Basic stVaults section. |
run-on-lido/stvaults-new/builders/product-guides/basic-stvaults/basic-isolated-staking-setup.md |
Adds an isolated-staking placeholder. |
run-on-lido/stvaults-new/builders/product-guides/basic-stvaults/etf-etp-product.md |
Adds an ETF/ETP placeholder. |
run-on-lido/stvaults-new/builders/product-guides/basic-stvaults/leveraged-staking-product.md |
Adds a leveraged-product placeholder. |
run-on-lido/stvaults-new/builders/product-guides/basic-stvaults/platform-to-manage-vaults.md |
Adds a management-platform placeholder. |
run-on-lido/stvaults-new/builders/product-guides/stvaults-defi-wrapper/index.md |
Adds the wrapper-guide section. |
run-on-lido/stvaults-new/builders/product-guides/stvaults-defi-wrapper/without-yield-strategy.md |
Adds a no-yield placeholder. |
run-on-lido/stvaults-new/builders/product-guides/stvaults-defi-wrapper/with-earneth.md |
Adds an EarnETH placeholder. |
run-on-lido/stvaults-new/builders/product-guides/stvaults-defi-wrapper/with-custom-strategy.md |
Adds a custom-strategy placeholder. |
run-on-lido/stvaults-new/concepts-and-reference/index.md |
Adds the reference landing page. |
run-on-lido/stvaults-new/concepts-and-reference/accounting-oracles.md |
Adds an oracle placeholder. |
run-on-lido/stvaults-new/concepts-and-reference/contracts-explained.md |
Adds a contracts placeholder. |
run-on-lido/stvaults-new/concepts-and-reference/defi-wrapper-technical-design.md |
Adds a wrapper-design placeholder. |
run-on-lido/stvaults-new/concepts-and-reference/exit-validators-permissions.md |
Adds an exit-permissions placeholder. |
run-on-lido/stvaults-new/concepts-and-reference/how-quarantine-works.md |
Adds a quarantine placeholder. |
run-on-lido/stvaults-new/concepts-and-reference/integration-overview.md |
Adds an integration placeholder. |
run-on-lido/stvaults-new/concepts-and-reference/lido-v3-technical-paper.md |
Adds a technical-paper placeholder. |
run-on-lido/stvaults-new/concepts-and-reference/pdg-flow-types.md |
Adds a PDG-flow placeholder. |
run-on-lido/stvaults-new/concepts-and-reference/risk-assessment-framework.md |
Adds a risk-framework placeholder. |
run-on-lido/stvaults-new/concepts-and-reference/rr-limits-fees-and-tiers.md |
Adds a tier-principles placeholder. |
run-on-lido/stvaults-new/concepts-and-reference/security-approach-and-audits.md |
Lists relevant security audits. |
run-on-lido/stvaults-new/concepts-and-reference/stvaults-detailed-technical-design.md |
Adds a technical-design placeholder. |
run-on-lido/stvaults-new/node-operators/index.md |
Adds the node-operator section. |
run-on-lido/stvaults-new/node-operators/change-meta-data.md |
Adds a metadata placeholder. |
run-on-lido/stvaults-new/node-operators/change-tier-and-steth-minting-limit.md |
Adds a tier-change placeholder. |
run-on-lido/stvaults-new/node-operators/consolidations.md |
Adds a consolidations placeholder. |
run-on-lido/stvaults-new/node-operators/control-node-operator-metrics.md |
Adds a metrics placeholder. |
run-on-lido/stvaults-new/node-operators/incentives-in-stvaults.md |
Adds an incentives placeholder. |
run-on-lido/stvaults-new/node-operators/node-operator-identification-guide.md |
Documents operator identification. |
run-on-lido/stvaults-new/node-operators/onboarded-node-operators.md |
Lists onboarded operators. |
run-on-lido/stvaults-new/node-operators/work-with-validators.md |
Adds validator-work placeholders. |
run-on-lido/stvaults-new/node-operators/defi-wrapper/index.md |
Adds the operator wrapper section. |
run-on-lido/stvaults-new/node-operators/defi-wrapper/manage-withdrawal-queue.md |
Adds a queue placeholder. |
run-on-lido/stvaults-new/node-operators/defi-wrapper/pdg-shortcut-bootstrap-guide.md |
Adds a PDG bootstrap placeholder. |
run-on-lido/stvaults-new/node-operators/defi-wrapper/update-strategy-implementation.md |
Adds a strategy-update placeholder. |
run-on-lido/stvaults-new/qualified-custodians/index.md |
Adds custody compatibility details. |
run-on-lido/stvaults-new/qualified-custodians/cactus.md |
Adds Cactus connection instructions. |
run-on-lido/stvaults-new/qualified-custodians/copper.md |
Adds Copper connection instructions. |
run-on-lido/stvaults-new/qualified-custodians/fireblocks.md |
Adds Fireblocks connection instructions. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/index.md |
Adds the vault-owner section. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/index.md |
Adds the Basic stVaults subsection. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/apply-oracle-reports.md |
Documents oracle report application. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/control-validators.md |
Adds a validator-control placeholder. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/disconnection.md |
Documents disconnection workflows. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/fulfil-redemptions-by-steth.md |
Adds a redemptions placeholder. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/health-emergency-guide.md |
Documents emergency recovery. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/health-monitoring-guide.md |
Documents health monitoring. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/meta-data.md |
Adds a metadata placeholder. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/metrics.md |
Defines vault metrics and formulas. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/rebalance-guide.md |
Documents rebalancing. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/roles-and-permissions.md |
Documents vault permissions. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/supply-withdraw-mint-repay.md |
Documents core vault operations. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/validate-setup.md |
Adds a validation placeholder. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/defi-wrapper/index.md |
Adds the owner wrapper section. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/defi-wrapper/staker-guides/index.md |
Adds staker guides. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/defi-wrapper/staker-guides/emergency-guide.md |
Adds an emergency placeholder. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/defi-wrapper/staker-guides/rebalance-guide.md |
Adds a rebalance placeholder. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/defi-wrapper/staker-guides/supply-withdraw-processes.md |
Adds a supply/withdraw placeholder. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/defi-wrapper/vault-owner-and-curator-guides/index.md |
Adds owner and curator guides. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/defi-wrapper/vault-owner-and-curator-guides/control-validators.md |
Adds a validator-control placeholder. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/defi-wrapper/vault-owner-and-curator-guides/disconnection-and-withdraw-connection-deposit.md |
Adds a disconnection placeholder. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/defi-wrapper/vault-owner-and-curator-guides/health-guide.md |
Adds a health placeholder. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/defi-wrapper/vault-owner-and-curator-guides/meta-data.md |
Adds a metadata placeholder. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/defi-wrapper/vault-owner-and-curator-guides/metrics.md |
Adds a metrics placeholder. |
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/defi-wrapper/vault-owner-and-curator-guides/roles-and-permissions.md |
Adds a permissions placeholder. |
docs/contracts/dashboard.md |
Clarifies role batch and renouncement behavior. |
Suppressed comments (2)
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/metrics.md:294
- This uses the annualized Lido Core APR as though it were the return for a single report period. Include the period/year fraction; otherwise the documented liquidity fee is overstated by the annualization factor.
run-on-lido/stvaults-new/vault-owners-curators-and-stakers/basic-stvaults/metrics.md:302 - The reservation fee also needs to convert the annualized APR to the report period. As written, each report applies a full year's return to the capacity.
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
1. rebalance guide review 2. builders page re-work 3. draft for basic stVault building guide 4. updated the onboarded node operators list
…cs into feat/stvaults-docs-rework
karinamaulitova
approved these changes
Aug 20, 2026
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
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.
No description provided.