Skip to content

docs: add Combo Charts visualization page - #333

Draft
jswir wants to merge 3 commits into
malloydata:mainfrom
jswir:docs/combo-chart-visualization
Draft

docs: add Combo Charts visualization page#333
jswir wants to merge 3 commits into
malloydata:mainfrom
jswir:docs/combo-chart-visualization

Conversation

@jswir

@jswir jswir commented Jul 23, 2026

Copy link
Copy Markdown
Contributor

What

Adds a Combo Charts page to the visualization docs for the new # combo_chart dual-axis chart type introduced in malloydata/malloy#3008 — two measures on two independent y-axes (bars + line), for comparing measures with different units or magnitudes (volume vs. rate, count vs. dollars).

  • New src/documentation/visualizations/combo_charts.malloynb: a properties table plus runnable examples using the existing flights sample — smart defaults, explicit channels with swapped marks, the crossover pitfall + axis pinning (y.min/y2.min), line styling (line_width/points), neutral axes (color_axes=false), embedded # y/# y2 tags, and nested-in-table.
  • src/table_of_contents.json: entry after Line Charts.

Content mirrors the in-repo renderer_tags_overview.md / renderer_tag_cheatsheet.md updates that ship in malloydata/malloy#3008, adapted into executable notebook examples.

⚠️ Blocked — draft, needs a renderer version bump

The # combo_chart tag is only understood by a @malloydata/render build that includes the plugin from malloydata/malloy#3008. This site currently pins:

"@malloydata/malloy":  "0.0.359",
"@malloydata/render": "0.0.359",

At that version the notebook will not render — the # combo_chart tag falls back / errors. To un-block:

  1. feat(render): add combo_chart dual-axis chart type malloy#3008 merges.
  2. A @malloydata/render release is cut that includes it. The render package is at 0.0.426 in-repo today (latest published 0.0.425), so the release including #3008 will be 0.0.426+ (whatever the actual release number is when it merges).
  3. Bump both @malloydata/malloy and @malloydata/render in package.json (they release in lockstep at the same version) to that release, and refresh the lockfile — ideally as its own commit so the version bump is reviewable separately from the doc page.

Only then does the page render live, and this PR can come out of draft. The Malloy queries in the notebook are valid today; only the # combo_chart rendering depends on the bump.

Test plan

  • table_of_contents.json validated as JSON.
  • Examples reuse fields already exercised across the visualization docs (dep_delay, distance, dep_time, carriers.nickname) against data/flights.parquet.
  • Live-render verification deferred until the renderer bump above lands.

jswir added 3 commits July 23, 2026 15:28
Document the new # combo_chart dual-axis chart type (malloydata/malloy#3008):
two measures on two independent y-axes (bars + line) for comparing measures
with different units or magnitudes.

- New src/documentation/visualizations/combo_charts.malloynb with a properties
  table and runnable examples (smart defaults, explicit channels/swapped marks,
  axis pinning, line styling, neutral axes, embedded tags, nested-in-table).
- Table-of-contents entry after Line Charts.
I, James Swirhun <james@credibledata.com>, hereby add my Signed-off-by to this commit: d2fab75

Signed-off-by: James Swirhun <james@credibledata.com>
The '# combo_chart { ... }' example spanned multiple lines, but Malloy's
'#' tag terminates at the newline, so only '# combo_chart {' was parsed.
Use the '#| ... |#' block-annotation form, which dedents and concatenates
its body into a single valid combo_chart tag.

Signed-off-by: James Swirhun <james@credibledata.com>
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.

1 participant