From a03aa9b674e4137bef412e8a5accd8bc5268d09f Mon Sep 17 00:00:00 2001 From: miller-da Date: Sun, 23 Aug 2026 21:23:03 -0500 Subject: [PATCH 1/2] propose new gs toc w canton splice split Signed-off-by: miller-da --- docs-main/docs.json | 71 +++++++++++-------- .../deployment/deployment-options.mdx | 4 ++ .../private-validators.mdx | 2 +- .../production-operations/pruning.mdx | 2 +- 4 files changed, 46 insertions(+), 33 deletions(-) diff --git a/docs-main/docs.json b/docs-main/docs.json index d68c120c7..b3b16ffaf 100644 --- a/docs-main/docs.json +++ b/docs-main/docs.json @@ -343,12 +343,11 @@ "global-synchronizer/understand/overview", "global-synchronizer/understand/introduction", "global-synchronizer/understand/validator-roles", - "global-synchronizer/extension-synchronizers/bft-orderer", "global-synchronizer/understand/installing-daml-sdk" ] }, { - "group": "Validator Deployment", + "group": "Validator Deployment (Splice)", "pages": [ "global-synchronizer/deployment/onboarding-process", "global-synchronizer/deployment/prerequisites", @@ -364,6 +363,7 @@ "global-synchronizer/deployment/validator-users", "global-synchronizer/deployment/validator-network-resets", "global-synchronizer/deployment/required-network-parameters", + "global-synchronizer/deployment/oidc-providers", "global-synchronizer/production-operations/validator-backups", "global-synchronizer/production-operations/validator-disaster-recovery", "global-synchronizer/production-operations/validator-postgres-migration", @@ -373,7 +373,7 @@ ] }, { - "group": "Super Validator Deployment", + "group": "Super Validator Deployment (Splice)", "pages": [ "global-synchronizer/deployment/kubernetes-deployment", "global-synchronizer/deployment/sv-network-resets", @@ -381,7 +381,10 @@ "global-synchronizer/production-operations/sv-upgrades", "global-synchronizer/production-operations/logical-synchronizer-upgrade", "global-synchronizer/deployment/sv-operations", - "global-synchronizer/deployment/sv-scratchnet" + "global-synchronizer/deployment/sv-scratchnet", + "global-synchronizer/production-operations/sv-backup", + "global-synchronizer/production-operations/disaster-recovery", + "global-synchronizer/production-operations/sv-pruning" ] }, { @@ -398,7 +401,7 @@ ] }, { - "group": "Canton Console", + "group": "Canton Console (Canton)", "pages": [ "global-synchronizer/canton-console/essential-commands", "global-synchronizer/canton-console/scripting", @@ -411,44 +414,50 @@ { "group": "Production Operations", "pages": [ - "global-synchronizer/production-operations/monitoring-setup", - "global-synchronizer/production-operations/splice-metrics-overview", - "global-synchronizer/production-operations/performance-optimization", - "global-synchronizer/production-operations/key-management", - "global-synchronizer/production-operations/party-management", - "global-synchronizer/production-operations/multi-sig", - "global-synchronizer/production-operations/kms-operations", - "global-synchronizer/production-operations/manage-packages", - "global-synchronizer/production-operations/upgrade-canton-nodes", - "global-synchronizer/production-operations/decommission-nodes", - "global-synchronizer/production-operations/node-backup-restore", - "global-synchronizer/deployment/identity-management", - "global-synchronizer/deployment/oidc-providers", - "global-synchronizer/deployment/docker", - "global-synchronizer/reference/metrics-reference", - "global-synchronizer/troubleshooting-guide/runbooks", { - "group": "Super Validator only", + "group": "Splice", "pages": [ - "global-synchronizer/production-operations/disaster-recovery", - "global-synchronizer/production-operations/pruning", - "global-synchronizer/production-operations/logical-synchronizer-upgrade", - "global-synchronizer/production-operations/sv-backup", - "global-synchronizer/production-operations/sv-pruning" + "global-synchronizer/production-operations/splice-metrics-overview", + "global-synchronizer/reference/metrics-reference", + "global-synchronizer/production-operations/scalability", + "global-synchronizer/troubleshooting-guide/runbooks" ] }, - "global-synchronizer/production-operations/scalability" + { + "group": "Canton participant nodes", + "pages": [ + "global-synchronizer/deployment/docker", + "global-synchronizer/deployment/identity-management", + "global-synchronizer/production-operations/party-management", + "global-synchronizer/production-operations/multi-sig", + "global-synchronizer/production-operations/manage-packages", + "global-synchronizer/production-operations/key-management", + "global-synchronizer/production-operations/kms-operations", + "global-synchronizer/production-operations/monitoring-setup", + "global-synchronizer/production-operations/performance-optimization", + "global-synchronizer/production-operations/pruning", + "global-synchronizer/production-operations/node-backup-restore", + "global-synchronizer/production-operations/upgrade-canton-nodes", + "global-synchronizer/production-operations/decommission-nodes" + ] + } ] }, { "group": "Dedicated Synchronizers", "pages": [ "global-synchronizer/extension-synchronizers/dedicated-synchronizers", + "global-synchronizer/extension-synchronizers/private-validators", "global-synchronizer/extension-synchronizers/hybrid-synchronizer-pattern", "global-synchronizer/extension-synchronizers/linking-validator-multi-sync", - "global-synchronizer/extension-synchronizers/private-validators", - "global-synchronizer/extension-synchronizers/synchronizer-operations", - "global-synchronizer/extension-synchronizers/synchronizer-monitoring" + { + "group": "Canton synchronizer nodes", + "pages": [ + "global-synchronizer/extension-synchronizers/bft-orderer", + "global-synchronizer/extension-synchronizers/synchronizer-operations", + "global-synchronizer/extension-synchronizers/synchronizer-monitoring" + ] + } ] }, { diff --git a/docs-main/global-synchronizer/deployment/deployment-options.mdx b/docs-main/global-synchronizer/deployment/deployment-options.mdx index 1caa4ce55..027750313 100644 --- a/docs-main/global-synchronizer/deployment/deployment-options.mdx +++ b/docs-main/global-synchronizer/deployment/deployment-options.mdx @@ -95,6 +95,10 @@ You can start with Docker Compose on DevNet and migrate to Kubernetes for TestNe Super Validators must use Kubernetes. The additional components (CometBFT node, sequencer, mediator, SV app, Scan service) require orchestration that Docker Compose does not support at production scale. See the [Kubernetes Deployment](/global-synchronizer/deployment/kubernetes-deployment) guide. +## Private-only validators + +A validator can also run on a dedicated synchronizer without any connection to the Global Synchronizer. See [Private-Only Validators](/global-synchronizer/extension-synchronizers/private-validators). + ## Next steps diff --git a/docs-main/global-synchronizer/extension-synchronizers/private-validators.mdx b/docs-main/global-synchronizer/extension-synchronizers/private-validators.mdx index a25e9c2a7..3b8c30194 100644 --- a/docs-main/global-synchronizer/extension-synchronizers/private-validators.mdx +++ b/docs-main/global-synchronizer/extension-synchronizers/private-validators.mdx @@ -1,5 +1,5 @@ --- -title: "Private Only Validators that are Just Connected to a Dedicated Synchronizers" +title: "Private-Only Validators" description: "Dedicated synchronizer users whose validator does not have a Global Synchronizer connection" --- diff --git a/docs-main/global-synchronizer/production-operations/pruning.mdx b/docs-main/global-synchronizer/production-operations/pruning.mdx index 19913e2c7..35984bf6c 100644 --- a/docs-main/global-synchronizer/production-operations/pruning.mdx +++ b/docs-main/global-synchronizer/production-operations/pruning.mdx @@ -1,6 +1,6 @@ --- title: "Pruning" -description: "Sequencer and CometBFT pruning configuration for Global Synchronizer nodes" +description: "Canton participant node pruning and automatic pruning configuration" --- This page covers Canton-side pruning for participant nodes and automatic pruning configuration. From defc58d9b06c0c0a48fd0e53b78f153760ba82d7 Mon Sep 17 00:00:00 2001 From: miller-da Date: Tue, 25 Aug 2026 14:43:46 -0500 Subject: [PATCH 2/2] splice on top of toc then canton Signed-off-by: miller-da --- docs-main/docs.json | 63 +++++++++++++++++++++------------------------ 1 file changed, 29 insertions(+), 34 deletions(-) diff --git a/docs-main/docs.json b/docs-main/docs.json index b3b16ffaf..891537235 100644 --- a/docs-main/docs.json +++ b/docs-main/docs.json @@ -401,7 +401,34 @@ ] }, { - "group": "Canton Console (Canton)", + "group": "Splice Operations", + "pages": [ + "global-synchronizer/production-operations/splice-metrics-overview", + "global-synchronizer/reference/metrics-reference", + "global-synchronizer/production-operations/scalability", + "global-synchronizer/troubleshooting-guide/runbooks" + ] + }, + { + "group": "Canton Operations", + "pages": [ + "global-synchronizer/deployment/docker", + "global-synchronizer/deployment/identity-management", + "global-synchronizer/production-operations/party-management", + "global-synchronizer/production-operations/multi-sig", + "global-synchronizer/production-operations/manage-packages", + "global-synchronizer/production-operations/key-management", + "global-synchronizer/production-operations/kms-operations", + "global-synchronizer/production-operations/monitoring-setup", + "global-synchronizer/production-operations/performance-optimization", + "global-synchronizer/production-operations/pruning", + "global-synchronizer/production-operations/node-backup-restore", + "global-synchronizer/production-operations/upgrade-canton-nodes", + "global-synchronizer/production-operations/decommission-nodes" + ] + }, + { + "group": "Canton Console Reference", "pages": [ "global-synchronizer/canton-console/essential-commands", "global-synchronizer/canton-console/scripting", @@ -411,38 +438,6 @@ "global-synchronizer/canton-console/getting-started-tutorial" ] }, - { - "group": "Production Operations", - "pages": [ - { - "group": "Splice", - "pages": [ - "global-synchronizer/production-operations/splice-metrics-overview", - "global-synchronizer/reference/metrics-reference", - "global-synchronizer/production-operations/scalability", - "global-synchronizer/troubleshooting-guide/runbooks" - ] - }, - { - "group": "Canton participant nodes", - "pages": [ - "global-synchronizer/deployment/docker", - "global-synchronizer/deployment/identity-management", - "global-synchronizer/production-operations/party-management", - "global-synchronizer/production-operations/multi-sig", - "global-synchronizer/production-operations/manage-packages", - "global-synchronizer/production-operations/key-management", - "global-synchronizer/production-operations/kms-operations", - "global-synchronizer/production-operations/monitoring-setup", - "global-synchronizer/production-operations/performance-optimization", - "global-synchronizer/production-operations/pruning", - "global-synchronizer/production-operations/node-backup-restore", - "global-synchronizer/production-operations/upgrade-canton-nodes", - "global-synchronizer/production-operations/decommission-nodes" - ] - } - ] - }, { "group": "Dedicated Synchronizers", "pages": [ @@ -502,7 +497,7 @@ ] }, { - "group": "Reference", + "group": "Canton Detailed Reference", "pages": [ "global-synchronizer/reference/canton-console-reference", "global-synchronizer/reference/canton-console-commands",