Skip to content

docs: document the 1.52.0 feature wave (reference, concepts, dagster)#930

Merged
hugocorreia90 merged 1 commit into
mainfrom
docs/document-1.52.0-reference
Jun 19, 2026
Merged

docs: document the 1.52.0 feature wave (reference, concepts, dagster)#930
hugocorreia90 merged 1 commit into
mainfrom
docs/document-1.52.0-reference

Conversation

@hugocorreia90

Copy link
Copy Markdown
Contributor

PR 1 of a 3-part sweep documenting the engine 1.52.0 feature wave, which shipped after the last docs overhaul and was almost entirely undocumented (found by a coverage audit). This PR covers the reference, concept, and dagster pages; a follow-up covers discovery/positioning pages, and a third adds runnable POCs.

Correctness fixes (these were wrong on main)

Reference

  • model-format.md — five new sidecar-block sections: [[surrogate_key]], [[tests]], [[use_test]], [[test]], [columns.<name>], plus group/[args] rows in the Fields table. Per-column docs are scoped to rocky catalog --output json (not the rocky docs HTML, which has no column introspection).
  • cli.md + commands/modeling.md — the new rocky emit-sql verb (+ backfilled rocky catalog), the rocky test unit_tests summary, the per-column description in catalog output, and a populated rocky compile models_detail example with a tags object.
  • json-output.md, configuration.md, glossary.mdunit_tests/tags/failures-shape notes, a config-groups cross-reference, and surrogate-key + config-group glossary entries.

Concepts & Dagster

  • testing.md (declarative + unit-test sections), data-quality-checks.md ([[test]] vs [[tests]] callout), sql-generation.md (surrogate-key SQL + dbt_utils parity), schema-patterns.md (config-groups distinction).
  • dagster/{translator,derived-models,types,resource} — the model-tag projection (get_model_tags), ModelDetail.tags, and the TestOutput/CiOutput aliases.

How this was produced & verified

15 files, one agent per file, each draft adversarially verified against the source (accuracy + de-AI prose standard), then a cross-link/terminology sweep. The verify pass caught real issues — e.g. a draft wrongly claimed rocky catalog has no JSON mode (it does; emit-sql doesn't), and the compile example's signals string was checked verbatim against the live dagster fixture. +826 / −10 across 15 files (deletions are the two correctness rewrites + a couple of hedge phrasings).

  • astro build green (89 pages, no frontmatter/MDX/link errors).
  • GOLD/proprietary grep clean — the only gold matches are medallion-layer (schema: "gold", tier: "gold"), consistent with the existing bronze-layer/silver-layer docs.

🤖 Generated with Claude Code

… + 2 correctness fixes

Adds coverage for features that shipped in engine 1.52.0 after the last docs
overhaul, grounded against the source and verified file-by-file.

Reference:
- model-format.md: new [[surrogate_key]], [[tests]], [[use_test]], [[test]], and
  [columns.<name>] sidecar-block sections + group/[args] Fields-table rows.
- cli.md + commands/modeling.md: the new rocky emit-sql verb (+ backfill catalog),
  the rocky test unit_tests summary, per-column description in catalog output, and
  a fully-populated compile models_detail example with a tags object.
- json-output.md, configuration.md, glossary.md: unit_tests/tags/failures-shape
  notes, a config-groups pointer, and surrogate-key + config-group glossary entries.

Concepts: testing.md (declarative + unit-test sections), data-quality-checks.md
([[test]] vs [[tests]] callout), sql-generation.md (surrogate-key SQL), and
schema-patterns.md (config-groups vs source-schema-pattern distinction).

Dagster: translator/derived-models/types/resource for the model-tag projection
(get_model_tags), ModelDetail.tags, and the TestOutput/CiOutput aliases.

Correctness fixes:
- migrate-from-dbt.md: emitted [[test]] blocks now execute under rocky test as of
  engine-v1.52.0 (#899); the prior 'not yet wired' clause was stale.
- testing.md: test failures are {name, error} objects, not positional tuples (#924).
@hugocorreia90 hugocorreia90 merged commit 8e05542 into main Jun 19, 2026
7 checks passed
@hugocorreia90 hugocorreia90 deleted the docs/document-1.52.0-reference branch June 19, 2026 15:46
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