Skip to content

docs(ws5): Analytics Datasets guide (ADR-0021 Phase 2 closeout) - #1673

Merged
os-zhuang merged 1 commit into
mainfrom
adr-0021-phase2-closeout
Jun 10, 2026
Merged

docs(ws5): Analytics Datasets guide (ADR-0021 Phase 2 closeout)#1673
os-zhuang merged 1 commit into
mainfrom
adr-0021-phase2-closeout

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

WS5 of the ADR-0021 Phase 2 closeout: a hand-written Analytics Datasets guide for the dataset semantic layer (content/docs/guides/analytics-datasets.mdx), wired into the Guides nav, plus an objectstack-ui SKILL cross-link.

Covers: why the semantic layer (no joins / metric drift / no source of truth), authoring (defineDataset — dimensions/measures/derived/certified/include), binding dashboards & reports, cross-object joins, the REST query surface, and the dual-form → single-form migration posture. Reference pages auto-generate from the zod schemas, so only the guide is hand-written.

Remaining closeout (NOT in this PR — see notes)

The delete-old-form step (#5) is intentionally deferred: its gate is unmet (2 list-chart views + platform-objects system_overview are still inline-only; needs a new ListView→dataset binding), the vendored console predates objectui#1612 (single-form would drop filters), and removing inline fields is a breaking @objectstack/spec major. Sequence: finish remaining migrations → re-bump console with #1612 → then delete inline as a focused major-version PR.

🤖 Generated with Claude Code

Hand-written guide for the dataset semantic layer: why it exists (no joins /
metric drift / no source of truth), authoring (`defineDataset` with
dimensions/measures/derived/certified), binding dashboards (`dataset` +
`dimensions` + `values` + `filter`→runtimeFilter) and reports (`dataset` +
`rows` + `values` + `runtimeFilter`), cross-object joins via `include`, the
REST query surface, and the dual-form → single-form migration posture. Wired
into the Guides nav; objectstack-ui SKILL cross-links it and notes the
widget-filter → runtimeFilter rule. (Reference pages auto-generate from the
zod schemas.)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercelBot commented Jun 10, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

ProjectDeploymentActionsUpdated (UTC)
specReadyReadyPreview, CommentJun 10, 2026 3:20am

Request Review

@github-actionsgithub-actionsBot added documentation Improvements or additions to documentation size/m labels Jun 10, 2026
@os-zhuang
os-zhuang merged commit a16bb80 into mainJun 10, 2026
10 of 11 checks passed
@os-zhuang
os-zhuang deleted the adr-0021-phase2-closeout branch June 10, 2026 03:18
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentationImprovements or additions to documentationsize/m

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant

@os-zhuang