Skip to content

docs: Wave 2 fixes (KI-004 to KI-211, KI-247 to KI-259) - #29

Merged
viethqb merged 2 commits into
mainfrom
docs/wave2-fixes
Oct 22, 2026
Merged

viethqb merged 2 commits into
mainfrom
docs/wave2-fixes

Conversation

@viethqb

@viethqb viethqb commented Oct 22, 2026

Copy link
Copy Markdown
Member

Documentation for Wave 2 of the Known-issues fix programme. Every statement was checked against the merged platform PRs #720 (Data API), #721 (SQL Lab), #724 (charts) and #725 (datasets): their descriptions, their diffs and the code on platform main (fbd2e874).

Pages changed (39, plus known-issues)

  • SQL Lab (#721): explore/sql-lab/editor.md (row limit appended after ORDER BY, the Results were limited chip on every cut result, the fallback wrapper, Query cancelled / Cancelled after N s, the new timeout message, ⌘K inside the editor and the chord trade-off), results.md (floats rounded to 15 significant digits on screen only), query-errors.md (Query not started, line positions, one engine: prefix), parameters.md, save-as-dataset.md (trailing ;, duplicate column 400), index.md
  • Datasets and metrics (#725): columns.md (Dimension and Filter now read, Time kept on Refresh, Display name as default column title, delete confirmation), calculated-columns.md, metrics.md (aggregate check, rename rewrites charts, 409 and typed confirmation on delete), organize.md (Trash dialog, notice on charts, delete refused while charts use the dataset and typed-name delete, Duplicate for both kinds), creating-a-dataset.md, index.md, permissions.md, refresh-and-sync.md, usage-and-preview.md; charts/table.md, charts/column-formatting.md, dashboards/filters.md (mapping offers only Filter-on columns)
  • Charts (#724): the-chart-editor.md (Change keeps cartesian config, .png only for chart images, 10,000-row note, Row limit hidden for single-row types, Dimension pickers), row.md, cartesian-settings.md, progress.md, gauge.md, number.md, map.md, funnel.md, waterfall.md, dashboards/export-and-reports.md
  • Data API (#720): endpoints/config.md, endpoints/index.md, endpoints/publishing.md (path and method go live at publish, Pending publish, 404 at the old URL with no redirect, 409 when another endpoint serves the URL, rollback at its own URL), endpoints/access.md (revoke note only for workspace-role inheritance), endpoints/parameters.md (constraint labels), endpoints/try-it.md, openapi.md, overview.md
  • Get started and troubleshooting: get-started/first-dashboard.md (ORDER BY note removed), troubleshooting/queries-fail.md, troubleshooting/engine-406-502.md
  • REST reference regenerated from platform main's openapi.json (separate commit): datasets.md (duplicate, 409 in_use, confirm, viz_type, deleted_at, refresh columns), data-api.md (live_method / live_path, inherits_invoke), index.md

Known issues

Closed with a Status note: KI-023, KI-024, KI-026, KI-180 (#720); KI-004, KI-006, KI-078, KI-079, KI-081, KI-086, KI-087, KI-095, KI-154, KI-211 (#721); KI-043, KI-044, KI-045, KI-046, KI-047, KI-049, KI-051, KI-057, KI-072, KI-163, KI-164, KI-165 (#724); KI-096, KI-098, KI-099, KI-100, KI-102, KI-103, KI-105, KI-110, KI-111, KI-158, KI-166 (#725). KI-101 is partly fixed (#725): a blank column name is refused, but a column already saved with an empty name still cannot be deleted. KI-006 reproduced and was fixed. No S1 row is open; none was in this wave.

Added at the end of the last table, each checked against platform main:

  • KI-247 dataset create with SQL the engine rejects answers 502
  • KI-248 SQL Lab re-renders the results grid on each keystroke
  • KI-249 Monaco chords starting with ⌘K unavailable in SQL Lab (KI-079 trade-off)
  • KI-250 a chart whose dataset is in the Trash opens with an empty Dataset picker
  • KI-251 dashboard card tables show column names, not display names
  • KI-252 bulk Move to Trash gives no notice about charts
  • KI-253 a draft can be saved at a URL another endpoint serves live
  • KI-254 Data API parameter pane capped at 40vh
  • KI-255 the Callers still use note wraps in a narrow column (from code)
  • KI-256 metric-vs-metric scatter Y-axis title clipped at the top (from code)
  • KI-257 box plot labels can overlap with Values to display = All
  • KI-258 trapezoid funnel is not offered .png
  • KI-259 region map with no matched row still draws a 0–1 legend

The intro paragraph names the source of KI-247 to KI-259. The B1 report's "REPORT-F2.md is tracked on main" was dropped: platform #722 removed it.

Screenshots and what I could not verify

  • No screenshot was re-shot. The demo stack at egret.localtest.me:18080 does not run platform main: its containers were built before the Wave 2 merges (from the B2 branch before its last commit), and the rebuild lock was held by another package agent the whole time, so I could not check or capture the new state.
  • Out of date now: data-api/endpoint-versions (badge over the note), data-api/endpoint-params (no constraint labels), data-api/endpoint-access (note on every grant), charts/row-data (largest bar at the bottom), charts/progress-data, charts/gauge-display and charts/scalar-display if they show Row limit, charts/editor-export and dashboards/card-export (1 million rows note), sql-datasets/sqllab-error (line 2:), sql-datasets/ds-usage (one icon for every chart), sql-datasets/ds-preview and charts/table-data (column names, not display names), sql-datasets/datasets-row-menu (no Duplicate on a physical dataset), ops/get-started/sql-lab-run (rows possibly out of order).
  • Documented from code, not observed: the dashboard filter mapping limited to Filter-on columns (unit-tested only in #725), the region-map note on a Vietnamese dataset, the error line positions in the metric and calculated-column examples, KI-255 and KI-256.

The build passes for en and vi with DOCUSAURUS_NO_PERSISTENT_CACHE=1 npm run build.

🤖 Generated with Claude Code

viethqb and others added 2 commits October 22, 2026 09:04
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Describe the product as it is on platform main after #720, #721, #724
and #725: SQL Lab row limit that keeps ORDER BY and marks cut results,
rounded floats, cancel and pre-start error panels, the timeout message,
Cmd K in the editor; chart export (.png only for chart images, 10,000
rows), Progress goal, row chart order, map unmatched-region note, Change
keeping cartesian config; dataset delete refused while charts use it,
typed confirmation, Trash notice, metric rename rewrite, Dimension and
Filter switches, display names, Duplicate for both kinds; Data API live
route and Pending publish, honest revoke note, constraint labels.

Close 38 known-issue rows (KI-101 partly) and add KI-247 to KI-259.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@viethqb
viethqb merged commit 9b57a0a into main Oct 22, 2026
2 checks passed
@viethqb
viethqb deleted the docs/wave2-fixes branch October 22, 2026 02:27
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