Skip to content

Port post-migration Splice docs updates#616

Merged
hrischuk-da merged 1 commit into
mainfrom
splice-docs-migration-audit-cf-docs
May 23, 2026
Merged

Port post-migration Splice docs updates#616
hrischuk-da merged 1 commit into
mainfrom
splice-docs-migration-audit-cf-docs

Conversation

@danielporterda
Copy link
Copy Markdown
Contributor

Summary

Ports the remaining documentation deltas from canton-network/splice after the initial cf-docs copy and after the partial refresh in 0baa65af.

Changes included:

  • Add the Scan Bulk Data API traffic_summary and app_activity_records sections for CIP-0104 preview fields.
  • Add SV Operations guidance for activityIngestionUserVersion.
  • Add Logical Synchronizer Upgrade guidance for additionalLegacy synchronizers.
  • Remove the upstream-deleted Grafana Dashboards section from Splice Metrics Overview.
  • Add Splice release notes for 0.6.4 and 0.6.5.
  • Remove the deleted-source SV and Validator major-upgrade pages, remove them from nav, and redirect their old routes to Logical Synchronizer Upgrade.
  • Update Exchange Node Operations so it no longer links to deleted major-upgrade routes or the removed Grafana section.

Notes

The audit found one remaining target-side provenance issue that this PR intentionally does not resolve: docs-main/global-synchronizer/reference/splice-metrics.mdx points at splice:docs/src/deployment/observability/metrics_reference.rst, but that source path is missing in current splice/main. That looks like stale source metadata rather than a source change to port.

Validation

  • jq empty docs-main/docs.json
  • git diff --check
  • Raw source-hash recheck: only the known stale splice-metrics.mdx provenance marker remains
  • direnv exec /Users/danielporter/control/.worktrees/splice-docs-migration-audit-cf-docs npx mintlify validate from docs-main

@mintlify
Copy link
Copy Markdown
Contributor

mintlify Bot commented May 22, 2026

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

Project Status Preview Updated (UTC)
cantonfoundation 🟢 Ready View Preview May 22, 2026, 6:53 PM

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

@hrischuk-da
Copy link
Copy Markdown
Contributor

My feedback via Slack

I am looking at https://github.com/canton-network/cf-docs/pull/616/changes.  I see sv-major-upgrade.mdx and validato-major-upgrade.mdx were deleted.  I'm not sure that is the right thing.  Those files may need to exist with a disclaimer that they don't apply to DevNet and that LSU is the mechanism.

I think a similar thing DevNet/TestNet/MainNet tab is needed for the Grafana dashboards  (docs-main/global-synchronizer/production-operations/splice-metrics-overview.mdx) where the release notes say
Observability
 - The release bundle now ships a separate Grafana dashboard folder validator-grafana-dashboards/ for Validator operators.

You may need to check with @Itai Segall.

For the other items, can you do a side by side comparison of the old splice docs and the new doc site.

@danielporterda
Copy link
Copy Markdown
Contributor Author

For the other items, can you do a side by side comparison of the old splice docs and the new doc site.

performed a comparison. confirming the copy worked faithfully.

@danielporterda danielporterda marked this pull request as ready for review May 22, 2026 20:18
@hrischuk-da hrischuk-da merged commit 46fb653 into main May 23, 2026
1 check passed
@hrischuk-da hrischuk-da deleted the splice-docs-migration-audit-cf-docs branch May 23, 2026 14:03
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