Fix configuration and OpenAPI schema links

[danielporterda]

Summary

Fixes the remaining broken links from the live-site audit that should not be handled as public-page redirects.

Changes:

• Replaces broken Scala reference links in the Canton configuration guide with the current Canton configuration reference page.
• Removes generated public hrefs to the non-public common-external.yaml source file from Splice OpenAPI security-scheme descriptions.

Root cause

The configuration guide still linked to Scala reference pages that are not published on the live Mintlify site. Separately, several generated OpenAPI descriptions exposed source-file-relative schema links, causing Mintlify to render a public href to a non-page YAML path.

Validation

• jq empty docs-main/docs.json
• git diff --check
• npm run validate:splice-mintlify-openapi-nav
• Parsed the touched OpenAPI YAML files with yaml.safe_load.
• Confirmed the replacement configuration reference live target returns HTTP 200.

[mintlify]

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

Project	Status	Preview	Updated (UTC)
cantonfoundation	🟢 Ready	View Preview	Jun 15, 2026, 3:42 PM

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