Skip to content

docs: show a Recall investigation on the homepage and across the docs - #1171

Merged
kvlonge merged 3 commits into
mainfrom
docs/recall-and-coherence
Oct 20, 2026
Merged

kvlonge merged 3 commits into
mainfrom
docs/recall-and-coherence

Conversation

@kvlonge

@kvlonge kvlonge commented Oct 20, 2026

Copy link
Copy Markdown
Contributor

Why

Recall shipped in 0.161.0 and 0.162.0, but the homepage, README and docs home did not mention it, the docs never showed it answering a question, and nothing said when to use Recall rather than sinks or the execution history API. The roadmap and feature comparison still listed ClickHouse as a future adapter.

Changes

  • Homepage step 09 "Investigate": an audit starts warning, sqb recall output shows what the build printed, and --backend warehouse finds the bad row and its cause. Real output from the example project, run on 0.162.0.
  • Recall page: the same investigation, start to finish, with full output.
  • Observability overview: a "Which to use" table (Recall, sinks, execution history, final JSON); compute log files described as also stored by Recall.
  • Execution history: points readers investigating past runs to Recall.
  • ClickHouse and SQLite adapter pages: a short Recall store section.
  • README and docs home: Recall section, sqb recall in the command table, ClickHouse and SQLite in the adapter list.
  • Roadmap and feature comparison: ClickHouse and SQLite are shipped (beta); Recall in the observability row.
  • Regenerated skill reference pages.

Verification

  • Website build (114 pages) and scripts/check_links.py: 0 broken links.
  • Every output block captured from real runs of the waffle shop example with sqlbuild 0.162.0.

@kvlonge
kvlonge enabled auto-merge (squash) October 20, 2026 00:07
@kvlonge
kvlonge merged commit 907cacb into main Oct 20, 2026
22 checks passed
@kvlonge
kvlonge deleted the docs/recall-and-coherence branch October 20, 2026 00:11
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