# Documentation
Choose your path:
| **New users** | [user/getting-started.md](user/getting-started.md) |
| **Evaluators / architects** | [adoption/overview.md](adoption/overview.md) |
| **Contributors** | [implementation/README.md](implementation/README.md) · [CONTRIBUTING.md](../CONTRIBUTING.md) |
| **Spec authors** | [editorial/baseline.md](editorial/baseline.md) · [SPEC.md](../SPEC.md) |
## User guides
| [getting-started.md](user/getting-started.md) | Install and validate your first contract in 5 minutes |
| [cli-guide.md](user/cli-guide.md) | All CLI commands, flags, and exit codes |
| [writing-contracts.md](user/writing-contracts.md) | Contract structure and field reference |
| [compatibility.md](user/compatibility.md) | Compatibility levels and evolution analysis |
| [json-output.md](user/json-output.md) | JSON output shapes for all commands |
| [faq.md](user/faq.md) | Frequently asked questions |
## Adoption
| [overview.md](adoption/overview.md) | Maturity, scope, security summary, evaluation checklist |
## Specification
| [SPEC.md](../SPEC.md) | Full DTCS 1.0 draft specification (normative, authoritative) |
| [ROADMAP.md](../ROADMAP.md) | Reference implementation milestones (Phases 0.1–0.10) |
| [CHANGELOG.md](../CHANGELOG.md) | Release notes |
## Editorial process
Documents governing how the specification is authored and reviewed:
| [baseline.md](editorial/baseline.md) | Mandatory editorial conventions |
| [style-guide.md](editorial/style-guide.md) | Terminology and prose style |
| [authoring-guide.md](editorial/authoring-guide.md) | Chapter structure and normative language |
| [review-checklist.md](editorial/review-checklist.md) | Pre-publication review checklist |
## Reference implementation
Guides for building the Rust crate in [src/](../src/):
| [README.md](implementation/README.md) | Implementation starter overview |
| [project-goal.md](implementation/project-goal.md) | Milestone scope |
| [architecture.md](implementation/architecture.md) | Pipeline architecture |
| [crate-layout.md](implementation/crate-layout.md) | Module layout |
| [model-guide.md](implementation/model-guide.md) | Canonical Object Model |
| [validation-guide.md](implementation/validation-guide.md) | Validation phases |
| [diagnostics-guide.md](implementation/diagnostics-guide.md) | Diagnostics model |
| [public-api.md](implementation/public-api.md) | Public API surface |
| [cli-spec.md](implementation/cli-spec.md) | CLI behavior |
| [implementation-phases.md](implementation/implementation-phases.md) | Build order |
| [testing-plan.md](implementation/testing-plan.md) | Test strategy |
| [rust-dependencies.md](implementation/rust-dependencies.md) | Crate dependencies |
| [spec-usage.md](implementation/spec-usage.md) | How to use SPEC.md during development |
| [non-goals.md](implementation/non-goals.md) | Out-of-scope features |