docs: move custom chart types out of data apps - #1107
Conversation
Chart types shipped their own gallery, builder and vocabulary, so the docs no longer need to explain them as a kind of data app. Folding them into the Custom charts reference puts them where people look for a chart type, next to the Vega editor they share a menu entry with. Screenshots for the gallery, builder and picker are still pending.
|
Preview deployment for your docs. Learn more about Mintlify Previews.
|
🤖 Documentation BotStatus🔗 Broken Links (Manual Fix Required)Click to view details |
The builder moved version history into a side panel behind History, so the prose describing version chips no longer matched what ships. Replaces the outdated Vega dropdown image and drops the eight visualization-* images the old data apps page referenced.
|
Screenshots are in, so this is out of draft. Four images, all taken on a local instance at 1.144.0 in light mode:
One prose fixThe repo moved from 1.132.0 to 1.144.0 while this was open, and Worth knowing for whoever reviews: Demo contentThe three chart types (stream graph, calendar heatmap, bullet chart) were generated on the local instance for these shots and renamed to sentence case - the auto-generated names carried a "Visualization" suffix that echoes the vocabulary this PR is retiring. |
🤖 Documentation Bot✅ All checks passed! No issues found. |
The page these replaced served light/dark pairs, and the reference pages render in whichever theme the reader is on.
🤖 Documentation Bot✅ All checks passed! No issues found. |
1 participant
Data app visualizations shipped a proper entry point in Phase 1: their own gallery, their own builder, and settled vocabulary (GLITCH-643). The docs still described them as a kind of data app you create from a template card that no longer exists (GLITCH-648 removed it), so this rewrites them around what shipped.
What changed
guides/data-apps/visualizationsis gone. Everything now lives inreferences/chart-types/custom-charts, which matches the UI: Custom is one menu entry covering two things.## Project chart types- the gallery, the builder, using one in a chart, saving and dashboards, permissions## Vega charts- the existing Vega content, now named Vega. Its limitations list is unchanged apart from saying "Vega charts" where it said "Custom Charts", which became ambiguous once Custom is the umbrella## Vega templates- untouchedNo customer-facing prose calls these data apps any more. The two remaining mentions are load-bearing: the self-hosting requirement and the CLI local-development tip.
Also: redirect from the old path, nav entry removed, and inbound links fixed in
chart-types/overview,guides/data-apps,guides/data-apps/maps, and both CLI reference mentions.Draft because screenshots are pending
Three images are referenced but not yet on disk, so
scripts/check-links.jsreports them and the page will render broken until they land:custom-chart-types-gallery.png- Browse -> Chart types, with a few cardscustom-chart-types-builder.png- sample-data preview, Configure panel, prompt bar, version chipscustom-chart-types-picker.png- Explorer config: Custom selected, picker showing Built in / Project, field mappingcustom-charts-drop-down.pngalso wants a retake in place - it shows the old dropdown, and the Quickstart step beside it now describes Custom -> Vega (JSON editor).Once those land, eight orphaned files under
images/guides/data-apps/visualization-*.pngcan be deleted.Note for review
Nothing is said about embedding. Phase 0's scope says embedded dashboard tiles and standalone embedded charts render, but GLITCH-592 is still Todo in Phase 2, so I left it out rather than guess.
🤖 Generated with Claude Code