Skip to content

v55 github links updates - #335

Open
evanorti wants to merge 57 commits into
mainfrom
release-versioning-v55
Open

v55 github links updates#335
evanorti wants to merge 57 commits into
mainfrom
release-versioning-v55

Conversation

@evanorti

Copy link
Copy Markdown
Contributor

Summary

Repairs every upstream GitHub reference in the SDK and CometBFT docs after the
v0.55 and v0.40 freeze, and adds tooling so the next release is a script run.

Changes

  • 160 links corrected. SDK 250 of 313 in latest/ now on release/v0.55.x,
    CometBFT 105 of 109 on v0.40.x. The remainder is deliberate: ADRs cite code
    as it stood at decision time, and version-specific upgrade and changelog pages
    keep their own version's refs.
  • 9 factual corrections found by checking prose against the code it links to.
  • 6 dead third-party links unlinked rather than repointed; those repos moved with
    no successor. The URLs stay visible as inline code.
  • Added check-github-refs.js and verify-links-live.js (40 fixture tests),
    plus the update-stale-refs skill for deciding when a stale link means the
    prose is wrong.

Review focus

enterprise/poa/distribution.mdx described enabling the PoA module account as
"recommended" with a fee_collector fallback. EndBlocker panics at block 1
otherwise, so a chain following that page would have halted on its first block.
Three other PoA claims were wrong in the same direction.

Most line ranges rest on the re-derivation method rather than individual
confirmation. All 91 changed pages were reviewed by agents that did not make the
changes, which caught one anchor bumped away from the version its own sentence
names.

Verification

459 unique URLs all resolve with no anchor past end of file; mint broken-links
clean; latest/next parity 0 both products; 40/40 fixture tests. Detail in
work-log/release-versioning-v55.md.

evanorti and others added 30 commits July 10, 2026 15:40
docs(sdk): kms rotation guide, release-impact fixes, prerequisites pass

Add rotate-key-remote-signer: rotate a consensus key held in Cosmos-KMS
(second signer process, shadow node, pubkey from /status). Test-verified
e2e on a localnet; includes the show-validator stray-key trap as a Danger.

Release-impact fixes to existing pages:
- run-production: replace the deprecated TMKMS walkthrough with
  Cosmos-KMS links and a deprecation note
- keyring: correct key algorithms to secp256k1 + ml_dsa_65 via
  --key-type (was ed25519 via --algo), link the new keys pages,
  fix a broken in-page anchor
- run-node: next-step links to key rotation and remote signing;
  jq links moved to jqlang.org

Guide improvements:
- complete, linked prerequisites on every keys/ and kms/ guide
- migrate-validator-ml-dsa: step 2 split into labeled staking / PoA /
  remote signer paths with the exact deltas (PoA passes ml_dsa_65)
- state-sync pointers on both shadow-node rotation pages
- post-quantum-keys: EIP-7702/8051/8141 linked and corrected
- Cosmos-KMS naming in prose, bare "kms" replaced with "the signer"
- remote-signing next steps completed (resolves placeholder TODO)
@greptile-apps

greptile-apps Bot commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Too many files changed for review. (815 files found, 100 file limit)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants