Skip to content

Remove HDM/major-upgrade docs mirroring Splice deprecation#623

Merged
Jatinp26 merged 2 commits into
mainfrom
mirror-splice-hdm-removal
May 25, 2026
Merged

Remove HDM/major-upgrade docs mirroring Splice deprecation#623
Jatinp26 merged 2 commits into
mainfrom
mirror-splice-hdm-removal

Conversation

@8bitpal
Copy link
Copy Markdown
Collaborator

@8bitpal 8bitpal commented May 25, 2026

Summary

Mirrors canton-network/splice@25dd870a"Remove HDM&DR docs and reference LSU docs only" (Splice PR #5253), which deleted the major-upgrade procedure pages from Splice and replaced the upgrade vocabulary with version vs protocol upgrades (LSU).

Changes

  • Deleted sv-major-upgrade.mdx and validator-major-upgrade.mdx (upstream sources were deleted; our pages were the only remaining copies).
  • Deleted 4 now-orphaned snippet files in docs-main/snippets/external/splice/main/ that were imported only by those two pages.
  • Removed both nav entries from docs-main/docs.json (mirrors upstream toctree removal).
  • Updated terminology in locally-authored pages from "major upgrade" → "version upgrade" / "protocol upgrade":
    • docs-main/appdev/faq.mdx (2 lines)
    • docs-main/global-synchronizer/troubleshooting-guide/performance-issues.mdx (1 line)
  • Retargeted 4 broken links in docs-main/integrations/exchanges/node-operations.mdx from the deleted validator-major-upgrade slug to the new validator-upgrades index. Deep anchors are dropped since they don't translate to LSU semantics.

The local sv-upgrades.mdx and validator-upgrades.mdx mirrors are already in sync with upstream's refreshed content (hashes match) — no edits needed for those.

Mirrors canton-network/splice commit 25dd870a ("Remove HDM&DR docs and
reference LSU docs only", #5253), which deleted the major-upgrade
procedure from Splice and replaced it with Logical Synchronizer Upgrade.

Local changes:

- Delete docs-main/global-synchronizer/production-operations/sv-major-upgrade.mdx
  and validator-major-upgrade.mdx (upstream sources gone).
- Delete the 4 orphaned snippet files in
  docs-main/snippets/external/splice/main/ that were imported only by
  those two MDX pages.
- Remove the two nav entries from docs-main/docs.json (mirrors the
  upstream toctree removal).
- Update terminology in locally-authored pages from "major upgrade" to
  "version upgrade" / "protocol upgrade" in:
  - docs-main/appdev/faq.mdx (2 lines)
  - docs-main/global-synchronizer/troubleshooting-guide/performance-issues.mdx (1 line)
- Retarget 4 broken links in
  docs-main/integrations/exchanges/node-operations.mdx from the deleted
  validator-major-upgrade slug to the new validator-upgrades index.
  Deep anchors are dropped (they don't translate to LSU semantics).

Splice's sv-upgrades.mdx and validator-upgrades.mdx local mirrors are
already in sync with upstream's refreshed content (hashes match), so
they don't need refresh in this PR.

A follow-up issue tracks the remaining inconsistent "major upgrade" /
"HDM" prose in upstream-mirrored pages (sv-scratchnet, sv-helm,
node-operations.mdx body, upgrades-on-global-sync) where upstream
itself hasn't caught up yet.
@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 25, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
cantonfoundation 🟢 Ready View Preview May 25, 2026, 3:26 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

…oval

# Conflicts:
#	docs-main/integrations/exchanges/node-operations.mdx
@Jatinp26 Jatinp26 merged commit 73457f6 into main May 25, 2026
1 check passed
@Jatinp26 Jatinp26 deleted the mirror-splice-hdm-removal branch May 25, 2026 15:56
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