Skip to content

feat: stValuts doc center rework - #954

Merged
dry914 merged 34 commits into
developfrom
feat/stvaults-docs-rework
Aug 20, 2026
Merged

feat: stValuts doc center rework#954
dry914 merged 34 commits into
developfrom
feat/stvaults-docs-rework

Conversation

@dry914

@dry914 dry914 commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

No description provided.

@dry914 dry914 self-assigned this Jul 29, 2026
@dry914 dry914 added the documentation Improvements or additions to documentation label Jul 29, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread run-on-lido/stvaults-new/node-operators/node-operator-identification-guide.md Outdated
Comment thread run-on-lido/stvaults-new/builders/product-guides/index.mdx Outdated
Comment thread run-on-lido/stvaults-new/qualified-custodians/fireblocks.md Outdated
@dry914
dry914 changed the base branch from main to develop August 20, 2026 14:21
@dry914
dry914 marked this pull request as ready for review August 20, 2026 14:21
@dry914
dry914 requested review from a team as code owners August 20, 2026 14:21
@dry914
dry914 merged commit c936e8e into develop Aug 20, 2026
@dry914
dry914 deleted the feat/stvaults-docs-rework branch August 20, 2026 14:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants