Port four upstream RSTs verbatim: validator/SV upgrades, LSU, exchange node-ops#320
Merged
hrischuk-da merged 1 commit intomainfrom May 5, 2026
Merged
Conversation
…doc-site refs
Closes the 5 Group B residuals from the upstream-link gap analysis. All content
brought across verbatim from upstream RST sources, with COPIED markers carrying
the upstream MD5-prefix hash. RST -> MDX syntactic conversions limited to:
``X`` -> `X`
:ref:`label` -> [<target's title>](/local/path) (visible text matches the
target page title, like Sphinx renders the bare :ref:)
:ref:`text <slug>` -> [text](/local/path) or *text* if no local target
Upstream RSTs ported (sources fetched from docs.dev.sync.global Sphinx _sources/
and DACH-NY/docs-website private repo):
1. splice:docs/src/validator_operator/validator_upgrades.rst (1951360a)
-> /global-synchronizer/production-operations/upgrade-procedures
under ## Minor Upgrades > ### Validator nodes (verbatim COPIED block).
Replaces the previously broken external anchor
docs.sync.global/validator_operator/validator_compose.html#upgrading
docs.sync.global/validator_operator/validator_k8s.html#upgrading
(both anchors do not exist upstream; the canonical page is validator_upgrades.rst).
2. splice:docs/src/sv_operator/sv_upgrades.rst (5405319d)
-> same upgrade-procedures page, ## Minor Upgrades > ### Super Validator nodes.
Replaces the pre-existing paraphrased SV block (was marked
hash="sv-minor-upgrades" placeholder, "adapted" warning) with a verbatim port.
3. splice:docs/src/sv_operator/sv_logical_synchronizer_upgrade.rst (0cf8ccb8)
-> new page /global-synchronizer/production-operations/logical-synchronizer-upgrade
(171 lines, verbatim COPIED block). Surfaced as a gap when porting #2:
sv_upgrades.rst references logical synchronizer upgrades via :ref:; that
cross-ref now resolves to a real local page. Internal :ref:`#anchor` cross-
refs within the LSU RST resolved as MDX in-page links; cross-refs to other
unported RSTs (validator_roll_forward_lsu, validator_acs_mismatches,
offset-checkpoints) italicized.
Nav: added under Production Operations > "Super Validator only" (3x versions).
4. docs-website:docs/replicated/splice-wallet-kernel/devnet/src/exchange-integration/node-operations.rst (7a5fbddf)
-> new page /integrations/exchanges/node-operations (~250 lines, verbatim
COPIED block). Covers Reward Minting, Setup Exchange Parties (featured +
treasury + testing), Setup Ledger API Users, .dar File Management,
Monitoring, and Rolling out Major Splice Upgrades (with the Runbook).
Nav: added under Integrations > Exchange (3x versions).
Image wallet_ui.png fetched from docs.digitalasset.com/integrate/devnet/_images/
and saved at docs-main/images/exchange-integration/. MDX img src rewritten
to absolute /images/exchange-integration/wallet_ui.png.
External-link redirects:
- global-synchronizer/troubleshooting.mdx: collapsed the two broken Docker/k8s
upgrade-anchor bullets into a single link to upgrade-procedures#validator-nodes.
- global-synchronizer/production-operations/validator-major-upgrade.mdx: redirected
the two docs.digitalasset.com/integrate/devnet/exchange-integration links to
/integrations/exchanges/node-operations#rolling-out-major-splice-upgrades.
- integrations/wallet/guidance.mdx + sdks-tools/sdks/wallet-sdk.mdx: replaced
docs.dev.sync.global/app_dev/testing/localnet.html with /sdks-tools/development-tools/localnet.
Spot-checks clean on new files: 0 /docs-main/ prefixes, 0 unintended body h1, 0
unresolved RST :ref: patterns; docs.json validates.
Contributor
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
hrischuk-da
approved these changes
May 5, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes residuals from the upstream-link gap analysis. Four upstream RST sources ported verbatim into local pages with
COPIED_START/COPIED_ENDmarkers; five external-link references redirected to the new internal targets.Upstream RSTs ported
splice:docs/src/validator_operator/validator_upgrades.rst1951360a/global-synchronizer/production-operations/upgrade-procedures→## Minor Upgrades→### Validator nodessplice:docs/src/sv_operator/sv_upgrades.rst5405319d### Super Validator nodes(replaces pre-existing paraphrased block)splice:docs/src/sv_operator/sv_logical_synchronizer_upgrade.rst0cf8ccb8/global-synchronizer/production-operations/logical-synchronizer-upgrade(171 lines)docs-website:docs/replicated/splice-wallet-kernel/devnet/src/exchange-integration/node-operations.rst7a5fbddf/integrations/exchanges/node-operations(~250 lines)(3) was discovered as a gap while porting (2):
sv_upgrades.rstcross-references logical synchronizer upgrades via:ref:; that link now resolves to the new local LSU page.External link redirects
global-synchronizer/troubleshooting.mdx— two broken upgrade-anchor bullets (validator_compose.html#upgrading,validator_k8s.html#upgrading; neither anchor exists upstream) collapsed into one internal link to/global-synchronizer/production-operations/upgrade-procedures#validator-nodes.global-synchronizer/production-operations/validator-major-upgrade.mdx— twodocs.digitalasset.com/integrate/devnet/exchange-integration/...links redirected to/integrations/exchanges/node-operations#rolling-out-major-splice-upgrades.integrations/wallet/guidance.mdxandsdks-tools/sdks/wallet-sdk.mdx—docs.dev.sync.global/app_dev/testing/localnet.html→/sdks-tools/development-tools/localnet.Nav additions (
docs.json)global-synchronizer/production-operations/logical-synchronizer-upgradeadded to Production Operations → Super Validator only sub-group in MainNet/TestNet/DevNet (3 entries).integrations/exchanges/node-operationsadded to Integrations → Exchange group in MainNet/TestNet/DevNet (3 entries).