Skip to content

docs: correct out-of-date and wrong documentation - #977

Merged
kvlonge merged 5 commits into
mainfrom
docs/accuracy-sweep
Oct 6, 2026
Merged

kvlonge merged 5 commits into
mainfrom
docs/accuracy-sweep

Conversation

@kvlonge

@kvlonge kvlonge commented Oct 6, 2026

Copy link
Copy Markdown
Contributor

Why

Several docs pages had drifted from current behaviour: flags that no longer exist, wrong defaults, outdated sample output, invalid file locations and an undocumented --debug.

Changes

  • cli/build: global options (--project-dir, --no-color, --debug, --version) and which progress rows need --debug; removed --include-stale-upstreams, added --selection-diagnostics.
  • Test-only macro locations in concepts/macros, concepts/testing and declaration-scope visibility now match what compiles.
  • Audit defaults (error, delta_and_final), concurrency, clone target selection, load --vars, scenario flags and folders, and the custom adapter API corrected.
  • Sample output regenerated for compile, dag, debug, init, freshness, load, plan, lineage, rename, selectors and macros.
  • Quickstart and examples README file locations and steps corrected.
  • Bundled skill references regenerated.

Verification

  • Each change checked against sqb 0.134.8 on copies of the example projects, the CLI help, or the main source (lineage against main).

Add global options, including --debug, to the build reference and explain which progress rows need --debug. Describe where macros used only by tests can live. Fix outdated flags, sample output and file layouts across CLI and concept pages.
Audits default to error severity and the delta_and_final run scope, seeds load on every build, path-between selectors include every path, and project concurrency is no longer serial-only. Refresh selector error samples.
Custom adapter examples now import from the real module paths and call execute with keyword arguments. The generated dbt connection is named <target>_dbt_profile. The quickstart lists the loader and generic audit where the playground puts them.
@kvlonge
kvlonge enabled auto-merge (squash) October 6, 2026 13:41
@kvlonge
kvlonge merged commit 2979009 into main Oct 6, 2026
19 checks passed
@kvlonge
kvlonge deleted the docs/accuracy-sweep branch October 6, 2026 13:44
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