How to Read These Docs
Navigation guide and reading paths
Last reviewed: 2025-01-25
How to Read These Docs
This documentation is structured for precision. Here's how to navigate it effectively.
Documentation Principles
1. Precision Over Marketing
Every claim is verifiable. Every guarantee has an enforcement mechanism. We don't make statements we can't prove.
When we say "guarantee," we mean a property enforced by system design. When we say "SLO," we mean a measurable commitment. Read carefully.
2. Show, Don't Tell
Code examples are executable. Diagrams represent actual system behavior. When we say something works a certain way, we show you how.
3. Failure Is Documented
We document what happens when things break. Every capability has a corresponding failure mode. See Incident Posture for the full failure playbook.
Reading Paths
Choose your path based on your role and goal:
Evaluator Path (2-3 hours)
You're considering ΔOS and need to understand what it does.
- What is ΔOS? — Core concept
- What ΔOS Is Not — Category boundaries
- Guarantees — What we actually promise
- Intent — The fundamental unit
- Authority Boundaries — Who decides what
Developer Path (4-6 hours)
You're integrating ΔOS into your agent infrastructure.
- Developer Quickstart — Get running
- SDK Reference — API details
- Intent — Understand the model
- LIMs — Policy evaluation
- Architecture: Components — System design
Security/Compliance Path (3-4 hours)
You need to assess ΔOS for your security and compliance requirements.
- Guarantees — Security-relevant properties
- Authority Boundaries — Control model
- Audit Trail — Immutability and verification
- Incident Posture — Failure handling
- Data Handling — Data flow and retention
Section Overview
Overview
Start here. Understand what ΔOS is, what it isn't, and how to evaluate it.
Concepts
Core abstractions: Intent, LIMs, Evidence, Judgments. Read these to understand the model.
Architecture
System design: Components, data flow, audit trail, integration patterns. Read these to understand how it's built.
Developers
Integration guides, SDK reference, examples. Read these to build with ΔOS.
Models
Value attribution, measurement methodology, confidence bands. Read these to understand how we quantify impact.
Governance
Guarantees, incident posture, SLOs, billing mappings. Read these to understand operational commitments.
Glossary
Precise term definitions. Reference when terminology is unclear.
Callout Types
We use callouts to highlight important information:
Additional context or clarification.
Important caveats or potential pitfalls.
A property enforced by system design—not just a goal.
Critical information about security or data integrity.
Component Types
Guarantees Table
| Guarantee | Enforcement Mechanism | Verification |
|---|---|---|
| Example guarantee | Enforcement mechanism | How to verify |
Shows properties with their enforcement mechanisms and verification methods.
Truth Table
| Comparison | Option A | Option B |
|---|---|---|
| Feature 1 | Yes | No |
| Feature 2 | Value | Other value |
Compares capabilities or properties across categories.
Authority Boundary Diagram
Shows the separation of responsibilities between humans, the system, and LIMs.
Failure Narrative
Documents what happens during specific failure scenarios with capability status and recovery paths.
Finding Information
Search
Use the search bar to find specific terms or concepts.
Glossary
Every domain-specific term has a definition in the glossary. When you see unfamiliar terminology, check there first.
Cross-References
Pages link to related content. Follow these links to build complete understanding.
Feedback
If something is unclear, missing, or incorrect:
- Check if there's a related page that addresses your question
- Check the glossary for term definitions
- If documentation is genuinely unclear, that's a bug—let us know
We maintain these docs as a source of truth. Accuracy matters.