WRIT Docs

#Core Concepts Learning Path

This section introduces the foundational concepts behind WRIT in a structured order. Each page builds on the previous, so we recommend reading them in sequence.

#Reading Order

graph LR
  A[Expectations] --> B[Domains & Entities] --> C[Three-Valued Logic] --> D[Partitions & Predicates] --> E[Questions & Actions] --> F[Campaigns] --> G[Data Flow]
  style A fill:#ecfeff,stroke:#06B6D4,color:#0e7490
  style B fill:#ecfeff,stroke:#06B6D4,color:#0e7490
  style C fill:#ecfeff,stroke:#06B6D4,color:#0e7490
  style D fill:#ecfeff,stroke:#06B6D4,color:#0e7490
  style E fill:#ecfeff,stroke:#06B6D4,color:#0e7490
  style F fill:#ecfeff,stroke:#06B6D4,color:#0e7490
  style G fill:#ecfeff,stroke:#06B6D4,color:#0e7490

#What You Will Learn

Page Core Question What You Will Understand
Expectations Why does WRIT exist? How misalignment is formalised and measured.
Domains & Entities What things are we talking about? Entity types, entity sets, attributes, and relationships.
Three-Valued Logic What about missing data? True, false, unknown, void — and why the distinction matters.
Partitions & Predicates How are entities classified? Predicate evaluation and the five partition branches.
Questions & Actions What does WRIT produce? How unknowns become questions and failures become actions.
Campaigns How do expectations relate? Hierarchical expectations and scoped evaluation.
Data Flow How does it all fit together? The end-to-end pipeline from data to insight.

#Approach

Every concept page follows the same structure:

  • Prerequisites — which pages to read first
  • The problem this solves — a concrete business scenario
  • How WRIT handles it — the concept explained through the scenario
  • Worked example — a DSL snippet you can run
  • Common pitfalls — mistakes to watch for
  • What to read next — links to the next concept and related reference pages

#Alternative Paths

The concept pages and the reference guides are complementary — each layer adds depth without requiring the other. Once you've read through the concepts, head to the Guides for practical application.