Zen Discussions

Every design decision, with the alternatives that lost.

• ZDS 0001: The Zen Discussion Process

  Process document

• ZDS 0002: zenfmt: Architecture and Implementation

  Architecture and first-release plan for the zenfmt document converter

• ZDS 0003: The DOCX Reader

  Mapping, omissions, and round-trip expectations for the DOCX reader

• ZDS 0004: The RTF Reader

  Mapping, omissions, and round-trip expectations for the RTF reader

• ZDS 0005: The XLSX Reader

  Mapping, omissions, and round-trip expectations for the XLSX reader

• ZDS 0006: The ODT Reader

  Mapping, omissions, and round-trip expectations for the ODT reader

• ZDS 0007: The PPTX Reader

  Mapping, omissions, and round-trip expectations for the PPTX reader

• ZDS 0008: The ODS Reader

  Mapping, omissions, and round-trip expectations for the ODS reader

• ZDS 0009: The ODP Reader

  Mapping, omissions, and round-trip expectations for the ODP reader

• ZDS 0010: The EPUB Reader

  Mapping, omissions, and round-trip expectations for the EPUB reader

• ZDS 0011: The PDF Reader

  Mapping, omissions, and round-trip expectations for the native PDF reader

• ZDS 0012: The Legacy Binary Office Readers

  Mapping, omissions, and round-trip expectations for the DOC, XLS, PPT, and XLSB readers

• ZDS 0013: Layered Document IR and Writer Lowering

  A layered semantic IR with sparse facets and provably deterministic writer lowering, superseding the AST and writer sections of ZDS 0002

• ZDS 0014: The zenfmt Python Library: API and Implementation

  The implemented Python API, native boundary, uv workflow, packaging, benchmark, and release contract

• ZDS 0015: Browser WebAssembly and the zenfmt Project Site

  The implementation blueprint for the 0.2.0 browser WASM release, conversion playground, project website, HTML book and ZDS, and public benchmark dashboard

• ZDS 0016: The zenfmt Server: REST, Streaming, and the Administered Service

  The zenfmt server: reusable CLI and service libraries, REST and streaming conversion, two-role administration on embedded zaxonlite, observability, a themed Zig WebAssembly interface, and reproducible Tika and Docling comparisons