# Documentation Directory

This directory contains reference documentation for TOON-PHP development.

## Core Reference

### SPEC.md (48K)

The official TOON v1.3 specification (2025-10-31). Primary reference for all implementation work.

### spec-requirements.md (45K)

Structured extraction of all 142 normative requirements from the spec, organized by section with priority levels (MUST/SHOULD/MAY).

## Current Status

### decoder-conformance-review.md (36K)

Comprehensive analysis of decoder implementation against spec requirements. Shows 65% conformance (Grade C) with detailed gap analysis and recommendations.

### decoder-review-summary.md (5.5K)

Executive summary of the decoder conformance review with prioritized next steps.

## Standard Files

### CHANGELOG.md (1.4K)

TOON specification version history (v1.0 → v1.3).

### VERSIONING.md (4.3K)

Specification versioning policy explaining breaking vs non-breaking changes.

## Root Level Documentation

### ../TODO.md (3.8K)

Current implementation tasks and status tracking.

### ../TEST-COVERAGE-COMPLETE.md (2.6K)

Quick reference showing encoder work complete (298/298 tests) and decoder in progress (27/30 tests).

---

**Last Updated:** 2025-11-04
**Total Documentation:** 8 files (~145KB)
