Part of #2023. Prereq: Phase 1 complete (#2026, #2027).
Why
Several "why does Xorq do this?" concept pages are stubs or thin. These give
users mental models and are core to the agent/catalog/executable-memory spine.
Pages
docs/concepts/understanding_xorq/why_deferred_execution.qmd
Currently a 6-line stub. Target ~800–1200 words covering:
- What deferred execution means in Xorq (builds a graph, not immediate results).
- Why it matters for ML pipelines (full-pipeline optimization, cross-engine routing).
- Concrete eager-vs-deferred example showing the behavior difference.
- The tradeoff — added complexity; when to call
.execute() immediately.
- Connection to caching — deferred graph = known structure = cacheable nodes.
Source the "why" framing from the deferred-execution tutorial and expand into
standalone explanation.
docs/concepts/understanding_xorq/intelligent_caching_system.qmd
docs/concepts/understanding_xorq/why_content_addressed_artifacts.qmd (new)
Cover:
- What content-addressed hashing is (deterministic hash of the computation, not of time).
- Why Xorq uses it (reproducibility, cache validity, artifact identity).
- What it means in practice (same pipeline = same hash = reuse existing artifact).
- Connection to the catalog model.
Done when
Terminology gate
No-cloud language (per epic). Catalog = git repo of build artifacts.
Part of #2023. Prereq: Phase 1 complete (#2026, #2027).
Why
Several "why does Xorq do this?" concept pages are stubs or thin. These give
users mental models and are core to the agent/catalog/executable-memory spine.
Pages
docs/concepts/understanding_xorq/why_deferred_execution.qmdCurrently a 6-line stub. Target ~800–1200 words covering:
.execute()immediately.Source the "why" framing from the deferred-execution tutorial and expand into
standalone explanation.
docs/concepts/understanding_xorq/intelligent_caching_system.qmdtutorial-style, expand the "why" sections.
docs/concepts/understanding_xorq/why_content_addressed_artifacts.qmd(new)Cover:
Done when
why_deferred_execution.qmdis >=800 words with a concrete example.intelligent_caching_system.qmdassessed and expanded if needed.why_content_addressed_artifacts.qmdwritten.quarto renderpasses, no broken links.Terminology gate
No-cloud language (per epic). Catalog = git repo of build artifacts.