Skip to content

task: update stale content in the Zebra bookΒ #10948

Description

@natalieesk

Context

A 2026-07-14 assessment of the Zebra book found content that has been overtaken by releases and refactors. This issue updates that content.


Acceptance Criteria

  • book/src/dev/release-process.md β€” remove the "Zebra is in a pre-release state" note (lines 18-24; v6.0.0 is out); correct the support window from 16 weeks to 15 (zebrad/src/components/sync/end_of_support.rs); correct the claim that release-plz updates changelogs (.release-plz.toml sets changelog_update = false; the rename of [Unreleased] headings is a manual step)
  • book/src/dev/state-db-upgrades.md β€” add the four Ironwood (NU6.3) column families to the "Current State Database Format" table (ironwood_nullifiers, ironwood_anchors, ironwood_note_commitment_tree, ironwood_note_commitment_subtree, per zebra-state/src/service/finalized_state.rs); fix the claim that tx_loc_by_spent_out_loc is indexer-feature-only (it is registered unconditionally); fix the dangling reference at line 496 to a "Never" category / "Updates table" that doesn't exist on the page
  • book/src/dev/gcp-deployment-operations.md:60-63 β€” fix the keep_until/delete_protection guidance: the daily cleanup workflow does not honor these labels (the page itself says so at line 255); also fix the create-state-image job attribution here (line 247) and in book/src/dev/continuous-delivery.md:27 β€” the job lives in zfnd-deploy-integration-tests-gcp.yml, not zfnd-ci-integration-tests-gcp.yml
  • book/src/user/custom-testnets.md:100-109 and book/src/dev/private-testnet.md:146-154 β€” update the activation-height examples to include NU6.2 (3,364,600), NU6.3 (3,428,143), and the NU7 variant (distinct from Fix bug in the Private Testnet testing section of the Zebra bookΒ #9844)
  • book/src/user/fork-zebra-testnet.md β€” fix the dead code path at line 84 (zebra-rpc/src/methods/get_block_template_rpcs/ no longer exists) and remove the defunct yolo.money seeders from the example configs (full tutorial refresh is out of scope, see below)
  • book/src/user/mining-testnet-s-nomp.md:37-47 β€” remove the defunct yolo.money seeders; use the current defaults from zebra-network/src/config.rs
  • book/src/user/startup.md β€” refresh the example startup logs: they show the removed mainnet.is.yolo.money seeder and a state/v24 cache path (current DB format version is 28)
  • book/src/user/troubleshooting.md:54-59 β€” replace the legacy config names lookahead_limit/max_concurrent_block_requests (now serde aliases) with the canonical checkpoint_verify_concurrency_limit/download_concurrency_limit, and fix the dead docs.rs field anchor
  • book/src/dev/ecc-updates.md β€” update for the zcash_script + libzcash_script crate split (zebra-script/Cargo.toml); define or remove the unexplained acronym "ZODL" (line 3); fix the "cargo upgrade" link at line 35, which points at the unrelated cargo-upgrades crate instead of cargo-edit

Out of Scope

  • A full refresh of the fork-zebra-testnet.md tutorial.
  • Repositioning lightwalletd.md.

Blockers

None.


Related Issues / Advisories

None.

Metadata

Metadata

Assignees

No one assigned

    Type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions