Skip to content

Inconsistent 'major upgrade' / 'HDM' terminology in upstream-mirrored pages #624

@8bitpal

Description

@8bitpal

Context

Splice deprecated the Hard Domain Migration & Disaster Recovery (HDM&DR) procedure in canton-network/splice@25dd870a on 2026-04-27 (Splice PR #5253). The major-upgrade pages were deleted and the upgrade vocabulary was reframed as version upgrades vs protocol upgrades (the latter performed through Logical Synchronizer Upgrade).

PR #623 mirrored that deletion in this repo and updated locally-authored pages. However, several upstream-mirrored pages still contain references to "major upgrades", "Hard Migration", or "HDM" — because upstream itself (in Splice and DACH-NY/docs-website) hasn't fully caught up with the deprecation in those pages.

Pages with stale terminology

Mirrored from canton-network/splice (upstream still uses old terms)

  • docs-main/global-synchronizer/deployment/sv-scratchnet.mdx — has a section titled "How to run through a HDM" and multiple HDM references. Mirrored from splice/docs/src/sv_operator/sv_scratchnet.rst.
  • docs-main/global-synchronizer/deployment/kubernetes-deployment.mdx — line 53: "The migration ID is frozen at the value after the last major upgrade". Mirrored from splice/docs/src/sv_operator/sv_helm.rst.

Mirrored from DACH-NY/docs-website (upstream still uses old terms)

  • docs-main/appdev/modules/m5-deployment-progression.mdx — line 50: "Type 3 upgrades involve fundamental changes... These major upgrades require downtime (sometimes called Hard Migrations) and occur every three to four months." Mirrored from docs-website/replicated/quickstart/3.x/sdk/quickstart/upgrade/upgrades-on-global-sync.rst.
  • docs-main/integrations/exchanges/node-operations.mdx body (lines ~155–210, "Rolling out Major Splice Upgrades" section) — the section heading and prose still describe HDM behavior (ACS reset, offset reset, redeploy validator with state import). LSU preserves state, so the substantive guidance no longer applies. The 4 broken links were retargeted in PR Remove HDM/major-upgrade docs mirroring Splice deprecation #623 to validator-upgrades, but the surrounding prose was left intact. Mirrored from docs-website/replicated/splice-wallet-kernel/devnet/src/exchange-integration/node-operations.rst, which itself still links to docs.dev.sync.global/validator_operator/validator_major_upgrades.html (also a deleted upstream page).

Already correct (no action)

  • docs-main/global-synchronizer/release-notes/splice.mdx line 64 explicitly documents the deprecation: "Hard Domain Migrations (HDMs) and HDM-based disaster recovery are no longer supported". This is mirrored from splice/docs/src/release_notes.rst and is correct as-is.

Metadata

Metadata

Labels

No labels
No labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions