Skip to content

Migration: move data-formats and dashboard assets to S3#325

Open
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/dddfa3d8
Open

Migration: move data-formats and dashboard assets to S3#325
mintlify[bot] wants to merge 1 commit into
mainfrom
mintlify/dddfa3d8

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor

Summary

Ports clickhouse/clickhouse-docs#6489 to Mintlify: rewrites local /assets/... and /examples/...-dashboard.json links to point at the clickhouse-docs-assets S3 bucket, and removes the now-unused local files under assets/.

Changes

  • Dashboard configs (clickstack/integration-examples/*, clickstack/managed-onboarding/monitoring-aws-cloudwatch-logs.mdx, products/managed-postgres/monitoring/prometheus.mdx): TrackedLink href={'/examples/<name>-dashboard.json'}TrackedLink href={'https://clickhouse-docs-assets.s3.us-east-1.amazonaws.com/examples/<name>-dashboard.json'}.
  • Data-format assets (guides/clickhouse/data-formats/*): rewrote 37 markdown links from /assets/<file>https://clickhouse-docs-assets.s3.us-east-1.amazonaws.com/<file>. Also normalized arrays.jsonlarrays.json and object-per-line.jsonl (deleted, no refs remained) to match the exact S3 filenames used in the upstream PR.
  • Deleted the migrated files from assets/ (37 data-format files + cloudflare-logs-dashboard.json). Kept data-otel-traces.csv and integrations-fallback.json, which are Mintlify-only and out of scope.

Notes / ambiguity

  • Per the instructions, i18n directories (ar/, es/, fr/, ja/, ko/, pt-BR/, ru/, zh/) were not touched. Their TrackedLink href={'/<locale>/examples/...'} and /assets/... references still point at local paths and will need a follow-up sweep if/when those locales are re-synced.
  • guides/clickhouse/data-formats/json/formats.mdx previously linked to arrays.jsonl, but the upstream PR (and the S3 object confirmed 200 by the author) is arrays.json. I rewrote to the S3 form (arrays.json); double-check if intentional.
  • get-started/quickstarts/working-with-the-map-type.mdx still references /assets/data-otel-traces.csv; that file is not part of the upstream migration, so I left it in place.

Context

Upstream reason: shrink the docs repo and host large binary/example assets on S3. All 52 migrated S3 URLs were link-checked and returned 200 in the source PR.

@mintlify

mintlify Bot commented Jul 3, 2026

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated (UTC)
ClickHouse-docs 🟢 Ready View Preview Jul 3, 2026, 9:19 PM

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.

0 participants