Audit rendered docs.canton.network obvious issues

[danielporterda]

Summary

A rendered crawl of https://docs.canton.network/ found several high-confidence obvious issues on the live site. The crawl visited 1,180 rendered URLs in Chromium: 1,117 sitemap URLs plus 63 same-origin links discovered from rendered pages.

This issue body was updated to use GitHub-hosted screenshot thumbnails from branch issue-617-screenshot-assets. Click any thumbnail to open the full-size screenshot.

Full local audit artifact: /Users/danielporter/control/reference_rollout/docs-canton-rendered-obvious-issues-20260522

Broken rendered links / 404 pages

Problem page	Source page	Screenshot	Problem	Source hint
/app-dev/bindings-java/javadocs/com/daml/ledger/javaapi/data/Bool.html	Java Codegen		404 from old Java/Javadocs link	docs-main/sdks-tools/language-bindings/java-codegen.mdx
/app-dev/bindings-java/javadocs/com/daml/ledger/javaapi/data/ContractId.html	Java Codegen		404 from old Java/Javadocs link	docs-main/sdks-tools/language-bindings/java-codegen.mdx
/app-dev/bindings-java/javadocs/com/daml/ledger/javaapi/data/DamlCollectors.html	Java Codegen		404 from old Java/Javadocs link	docs-main/sdks-tools/language-bindings/java-codegen.mdx
/app-dev/bindings-java/javadocs/com/daml/ledger/javaapi/data/DamlList.html	Java Codegen		404 from old Java/Javadocs link	docs-main/sdks-tools/language-bindings/java-codegen.mdx
/app-dev/bindings-java/javadocs/com/daml/ledger/javaapi/data/DamlOptional.html	Java Codegen		404 from old Java/Javadocs link	docs-main/sdks-tools/language-bindings/java-codegen.mdx
/app-dev/bindings-java/javadocs/com/daml/ledger/javaapi/data/DamlTextMap.html	Java Codegen		404 from old Java/Javadocs link	docs-main/sdks-tools/language-bindings/java-codegen.mdx
/app-dev/bindings-java/javadocs/com/daml/ledger/javaapi/data/Date.html	Java Codegen		404 from old Java/Javadocs link	docs-main/sdks-tools/language-bindings/java-codegen.mdx
/app-dev/bindings-java/javadocs/com/daml/ledger/javaapi/data/Int64.html	Java Codegen		404 from old Java/Javadocs link	docs-main/sdks-tools/language-bindings/java-codegen.mdx
/app-dev/bindings-java/javadocs/com/daml/ledger/javaapi/data/Numeric.html	Java Codegen		404 from old Java/Javadocs link	docs-main/sdks-tools/language-bindings/java-codegen.mdx
/app-dev/bindings-java/javadocs/com/daml/ledger/javaapi/data/Party.html	Java Codegen		404 from old Java/Javadocs link	docs-main/sdks-tools/language-bindings/java-codegen.mdx
/app-dev/bindings-java/javadocs/com/daml/ledger/javaapi/data/Text.html	Java Codegen		404 from old Java/Javadocs link	docs-main/sdks-tools/language-bindings/java-codegen.mdx
/app-dev/bindings-java/javadocs/com/daml/ledger/javaapi/data/Timestamp.html	Java Codegen		404 from old Java/Javadocs link	docs-main/sdks-tools/language-bindings/java-codegen.mdx
/reference/scala/com-digitalasset-canton-config/cantonconfig	Canton Configuration Guide		404 from old Scala reference link	docs-main/global-synchronizer/reference/canton-configuration-guide.mdx
/reference/scala/com-digitalasset-canton-participant-config/remoteparticipantconfig	Canton Configuration Guide		404 from old Scala reference link	docs-main/global-synchronizer/reference/canton-configuration-guide.mdx
/reference/splice-token-metadata-service/get-registry-metadata-v1-info	Token Standard		404 from Token Standard OpenAPI link	docs-main/appdev/deep-dives/token-standard.mdx
/reference/splice-transfer-instruction-api/post-registry-transfer-instruction-v1-transfer-factory	Token Standard		404 from Token Standard OpenAPI link	docs-main/appdev/deep-dives/token-standard.mdx
/reference/splice-allocation-api/post-registry-allocations-v1-allocationid-choice-contexts-execute-transfer	Token Standard		404 from Token Standard OpenAPI link	docs-main/appdev/deep-dives/token-standard.mdx
/reference/splice-allocation-instruction-api/post-registry-allocation-instruction-v1-allocation-factory	Token Standard		404 from Token Standard OpenAPI link	docs-main/appdev/deep-dives/token-standard.mdx
/sdks-tools/api-reference/%7Cgsf_scan_url%7C/api/scan/v2/updates	Scan Bulk Data API		404 from unsubstituted |gsf_scan_url| link	docs-main/sdks-tools/api-reference/splice-scan-bulk-data-api.mdx
/sdks-tools/api-reference/%7Cgsf_scan_url%7C/api/scan/v0/state/acs/snapshot-timestamp	Scan Bulk Data API		404 from unsubstituted |gsf_scan_url| link	docs-main/sdks-tools/api-reference/splice-scan-bulk-data-api.mdx
/global-synchronizer/release-notes/release-notes	Upgrading from Previous Versions		404 release notes link	Also appears in docs-main/shared/support-channels.mdx
/common/src/main/openapi/common-external.yaml	Splice Validator API		404 asset/source path linked from rendered OpenAPI content	docs-main/openapi/splice/validator/*-external.yaml

React hydration/runtime exceptions

These pages raise Minified React error #418 while rendering in Chromium.

Problem page	Source page	Screenshot	Problem	Source hint
/appdev/reference/daml-standard-library	/appdev/reference/daml-standard-library		Rendered page raises Minified React error #418	Generated/reference rendered page
/appdev/reference/daml-standard-library/index	/appdev/reference/daml-standard-library/index		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/admin-api/protobuf	/reference/admin-api/protobuf		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/admin-api/protobuf/index	/reference/admin-api/protobuf/index		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/admin-api/protobuf/packages/com-digitalasset-canton-admin-health-v30	/reference/admin-api/protobuf/packages/com-digitalasset-canton-admin-health-v30		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/admin-api/protobuf/packages/com-digitalasset-canton-admin-mediator-v30	/reference/admin-api/protobuf/packages/com-digitalasset-canton-admin-mediator-v30		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/admin-api/protobuf/packages/com-digitalasset-canton-admin-participant-v30	/reference/admin-api/protobuf/packages/com-digitalasset-canton-admin-participant-v30		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/admin-api/protobuf/packages/com-digitalasset-canton-admin-sequencer-v30	/reference/admin-api/protobuf/packages/com-digitalasset-canton-admin-sequencer-v30		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/admin-api/protobuf/packages/com-digitalasset-canton-crypto-admin-v30	/reference/admin-api/protobuf/packages/com-digitalasset-canton-crypto-admin-v30		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/admin-api/protobuf/packages/com-digitalasset-canton-time-admin-v30	/reference/admin-api/protobuf/packages/com-digitalasset-canton-time-admin-v30		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/admin-api/protobuf/packages/com-digitalasset-canton-topology-admin-v30	/reference/admin-api/protobuf/packages/com-digitalasset-canton-topology-admin-v30		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/grpc-ledger-api-reference	/reference/grpc-ledger-api-reference		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/grpc-ledger-api-reference/com-daml-ledger-api-v2	/reference/grpc-ledger-api-reference/com-daml-ledger-api-v2		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/grpc-ledger-api-reference/com-daml-ledger-api-v2-admin	/reference/grpc-ledger-api-reference/com-daml-ledger-api-v2-admin		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/grpc-ledger-api-reference/com-daml-ledger-api-v2-interactive	/reference/grpc-ledger-api-reference/com-daml-ledger-api-v2-interactive		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/grpc-ledger-api-reference/com-daml-ledger-api-v2-testing	/reference/grpc-ledger-api-reference/com-daml-ledger-api-v2-testing		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/grpc-ledger-api-reference/details	/reference/grpc-ledger-api-reference/details		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/json-api-asyncapi-reference/operations/details	/reference/json-api-asyncapi-reference/operations/details		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/json-api-asyncapi-reference/operations/v2-commands-completions/details	/reference/json-api-asyncapi-reference/operations/v2-commands-completions/details		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/json-api-asyncapi-reference/operations/v2-state-active-contracts/details	/reference/json-api-asyncapi-reference/operations/v2-state-active-contracts/details		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/json-api-asyncapi-reference/operations/v2-updates-flats/details	/reference/json-api-asyncapi-reference/operations/v2-updates-flats/details		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/json-api-asyncapi-reference/operations/v2-updates-trees/details	/reference/json-api-asyncapi-reference/operations/v2-updates-trees/details		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/json-api-asyncapi-reference/operations/v2-updates/details	/reference/json-api-asyncapi-reference/operations/v2-updates/details		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/protobuf	/reference/protobuf		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/protobuf/index	/reference/protobuf/index		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/protobuf/packages/com-daml-ledger-api-v2	/reference/protobuf/packages/com-daml-ledger-api-v2		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/protobuf/packages/com-daml-ledger-api-v2-admin	/reference/protobuf/packages/com-daml-ledger-api-v2-admin		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/protobuf/packages/com-daml-ledger-api-v2-interactive	/reference/protobuf/packages/com-daml-ledger-api-v2-interactive		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/protobuf/packages/com-daml-ledger-api-v2-testing	/reference/protobuf/packages/com-daml-ledger-api-v2-testing		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/wallet-gateway-json-rpc/index	/reference/wallet-gateway-json-rpc/index		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/wallet-gateway-json-rpc/operations/dapp-api/details	/reference/wallet-gateway-json-rpc/operations/dapp-api/details		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/details	/reference/wallet-gateway-json-rpc/operations/dapp-remote-api/details		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/wallet-gateway-json-rpc/operations/details	/reference/wallet-gateway-json-rpc/operations/details		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/wallet-gateway-json-rpc/operations/signing-api/details	/reference/wallet-gateway-json-rpc/operations/signing-api/details		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/wallet-gateway-json-rpc/operations/user-api/details	/reference/wallet-gateway-json-rpc/operations/user-api/details		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/wallet-gateway-json-rpc/specs/dapp-api	/reference/wallet-gateway-json-rpc/specs/dapp-api		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/wallet-gateway-json-rpc/specs/dapp-remote-api	/reference/wallet-gateway-json-rpc/specs/dapp-remote-api		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/wallet-gateway-json-rpc/specs/signing-api	/reference/wallet-gateway-json-rpc/specs/signing-api		Rendered page raises Minified React error #418	Generated/reference rendered page
/reference/wallet-gateway-json-rpc/specs/user-api	/reference/wallet-gateway-json-rpc/specs/user-api		Rendered page raises Minified React error #418	Generated/reference rendered page
/sdks-tools/development-tools/pqs	/sdks-tools/development-tools/pqs		Rendered page raises Minified React error #418	Generated/reference rendered page

Visible TODO/TBD-style leaks

Problem page	Source page	Screenshot	Problem	Source hint
/appdev/deep-dives/external-signing-onboarding	/appdev/deep-dives/external-signing-onboarding		Visible # TODO(i27030): check the permission matches	docs-main/appdev/deep-dives/external-signing-onboarding.mdx
/reference/json-api-reference/v2partiesexternalallocate	/reference/json-api-reference/v2partiesexternalallocate		Visible TODO(#27670) support synchronizer aliases	Generated JSON API OpenAPI reference
/reference/json-api-reference/v2partiesexternalgenerate-topology	/reference/json-api-reference/v2partiesexternalgenerate-topology		Visible TODO(#27670) support synchronizer aliases	Generated JSON API OpenAPI reference
/sdks-tools/api-reference/splice-daml/splice-amulet/splice-amuletconfig	/sdks-tools/api-reference/splice-daml/splice-amulet/splice-amuletconfig		Visible TODO(M4-85): ...	Generated Splice Daml API reference
/sdks-tools/api-reference/splice-daml/splice-amulet/splice-fees	/sdks-tools/api-reference/splice-daml/splice-amulet/splice-fees		Visible TODO(M3-90): ...	Generated Splice Daml API reference
/sdks-tools/api-reference/splice-daml/splice-dso-governance/splice-dsorules	/sdks-tools/api-reference/splice-daml/splice-dso-governance/splice-dsorules		Visible TODO(#10063): ...	Generated Splice Daml API reference
/sdks-tools/development-tools/pqs/operate	/sdks-tools/development-tools/pqs/operate		Repeated visible correlation_id=tbd log examples	docs-main/sdks-tools/development-tools/pqs/operate.mdx

Reviewed false positives

The audit also flagged some raw text patterns that I did not treat as high-confidence defects: TypeScript import examples, GitHub Actions ${{ github.sha }}, Docker {{.Names}} / {{.State.OOMKilled}}, and pages that discuss HTTP errors such as Internal Server Error as content.

Raw artifacts

• Screenshot asset branch: https://github.com/canton-network/cf-docs/tree/issue-617-screenshot-assets/.github/issue-assets/617
• Curated report: /Users/danielporter/control/reference_rollout/docs-canton-rendered-obvious-issues-20260522/curated-report.md
• Raw findings: /Users/danielporter/control/reference_rollout/docs-canton-rendered-obvious-issues-20260522/findings.json
• Full results: /Users/danielporter/control/reference_rollout/docs-canton-rendered-obvious-issues-20260522/results.json
• React 418 URL list: /Users/danielporter/control/reference_rollout/docs-canton-rendered-obvious-issues-20260522/react-418-urls.txt
• Local screenshots: /Users/danielporter/control/reference_rollout/docs-canton-rendered-obvious-issues-20260522/screenshots/

[danielporterda]

Ran the Mintlify broken-links checker against fresh origin/main in /Users/danielporter/control/.worktrees/cf-docs-issue-617-mintlify-broken-links:

direnv exec /Users/danielporter/control/.worktrees/cf-docs-issue-617-mintlify-broken-links sh -lc 'cd docs-main && npx mintlify broken-links'

Result: exit status 1; Mintlify reported found 58 broken links in 13 files.

Coverage against this issue's broken rendered-link list:

• Caught 21 of the 22 broken rendered-link URLs.
• Caught the old Java/Javadocs links, old Scala reference links, Token Standard OpenAPI links, unsubstituted |gsf_scan_url|/... links, and /global-synchronizer/release-notes/release-notes.
• Did not catch /common/src/main/openapi/common-external.yaml; that one appears to come from rendered native OpenAPI content rather than a normal authored MDX link reported by mintlify broken-links.

Mintlify also reports additional broken links not included in the rendered-audit high-confidence list: placeholder network URLs such as |generic_sv_url|, |gsf_sv_url|, |generic_scan_url|, plain |gsf_scan_url|, https://url:port, missing PQS image assets, and additional Java-codegen //javadocs/.../Unit.html / Value.html links.

Raw output and summary are recorded locally under:

/Users/danielporter/control/reference_rollout/docs-canton-rendered-obvious-issues-20260522/mintlify-broken-links/