From ad51e1b2683612642771ffd252cf427dbaefbad5 Mon Sep 17 00:00:00 2001 From: draw me an elephant <68925779+drawmeanelephant@users.noreply.github.com> Date: Tue, 25 Aug 2026 19:24:28 -0400 Subject: [PATCH] fix(docs): quote summary values containing colons in front matter GitHub's YAML front-matter renderer rejected every doc whose summary value contained a colon-space ("mapping values are not allowed in this context"). Quote the 21 affected summary values so all doc front matter parses as valid YAML. --- docs/ARCHITECTURE.md | 2 +- docs/BLOCKS-PARSING.md | 2 +- docs/C-ABI.md | 2 +- docs/CAPABILITIES.md | 2 +- docs/CLEANROOM.md | 2 +- docs/COOKLANG.md | 2 +- docs/DOCUMENT-MODEL.md | 2 +- docs/ENTITIES.md | 2 +- docs/FEATURE-MATRIX.md | 2 +- docs/HTML-BLOCKS.md | 2 +- docs/IMAGES-PARSING.md | 2 +- docs/LEAF-BLOCKS.md | 2 +- docs/RAW-HTML.md | 2 +- docs/SESSION-1-REPORT.md | 2 +- docs/TASK-LISTS.md | 2 +- docs/TESTS.md | 2 +- docs/TEXTILE-PARITY.md | 2 +- docs/WIKILINKS.md | 2 +- docs/XHTML.md | 2 +- docs/github-pages.md | 2 +- docs/index.md | 2 +- 21 files changed, 21 insertions(+), 21 deletions(-) diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 60ca2d0..1e4ae38 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-13T00:00:00Z -summary: Oliver is a small, freestanding markup parsing and rendering library in Zig: markup infrastructure, not a publishing framework. +summary: "Oliver is a small, freestanding markup parsing and rendering library in Zig: markup infrastructure, not a publishing framework." --- # Oliver Architecture diff --git a/docs/BLOCKS-PARSING.md b/docs/BLOCKS-PARSING.md index 08fa2c2..df8a7fa 100644 --- a/docs/BLOCKS-PARSING.md +++ b/docs/BLOCKS-PARSING.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-12T00:00:00Z -summary: Contract for Oliver's container-block algorithm: block quotes and lists share the container stack (CommonMark section 5). +summary: "Contract for Oliver's container-block algorithm: block quotes and lists share the container stack (CommonMark section 5)." --- # Oliver Block Parsing: Container Blocks (Block Quotes, Lists) diff --git a/docs/C-ABI.md b/docs/C-ABI.md index d8593d5..7fe2c62 100644 --- a/docs/C-ABI.md +++ b/docs/C-ABI.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-16T00:00:00Z -summary: The stable C ABI for embedding Oliver from C, Rust, Python, Node, and other FFI consumers: the oliver_render / oliver_free surface, the memory-ownership contract, the error codes, and the CI-compiled example. +summary: "The stable C ABI for embedding Oliver from C, Rust, Python, Node, and other FFI consumers: the oliver_render / oliver_free surface, the memory-ownership contract, the error codes, and the CI-compiled example." --- # C ABI diff --git a/docs/CAPABILITIES.md b/docs/CAPABILITIES.md index 30f3133..7a66200 100644 --- a/docs/CAPABILITIES.md +++ b/docs/CAPABILITIES.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-14T00:00:00Z -summary: What Oliver parses and renders today on main: the user-facing overview of frontend capabilities. +summary: "What Oliver parses and renders today on main: the user-facing overview of frontend capabilities." --- # Oliver capabilities diff --git a/docs/CLEANROOM.md b/docs/CLEANROOM.md index bb15f3c..1ecfe9f 100644 --- a/docs/CLEANROOM.md +++ b/docs/CLEANROOM.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-13T00:00:00Z -summary: The binding clean-room contract for everyone who writes Oliver code: read it before adding syntax features. +summary: "The binding clean-room contract for everyone who writes Oliver code: read it before adding syntax features." --- # Oliver Clean-Room Rules diff --git a/docs/COOKLANG.md b/docs/COOKLANG.md index d808ec1..49242e5 100644 --- a/docs/COOKLANG.md +++ b/docs/COOKLANG.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-13T00:00:00Z -summary: Design and provenance contract for the first-class Cooklang (.cook) frontend: bytes in, a typed Recipe out. +summary: "Design and provenance contract for the first-class Cooklang (.cook) frontend: bytes in, a typed Recipe out." --- # Cooklang frontend: design contract diff --git a/docs/DOCUMENT-MODEL.md b/docs/DOCUMENT-MODEL.md index 72feb69..0a10ee1 100644 --- a/docs/DOCUMENT-MODEL.md +++ b/docs/DOCUMENT-MODEL.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-13T00:00:00Z -summary: The normalized typed document is the contract between dialect frontends and every future renderer: not HTML-shaped. +summary: "The normalized typed document is the contract between dialect frontends and every future renderer: not HTML-shaped." --- # Oliver Document Model diff --git a/docs/ENTITIES.md b/docs/ENTITIES.md index 200d916..d7b2f82 100644 --- a/docs/ENTITIES.md +++ b/docs/ENTITIES.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-12T00:00:00Z -summary: Contract for CommonMark section 2.5 entity and numeric character references: implemented, scorecard 17/17. +summary: "Contract for CommonMark section 2.5 entity and numeric character references: implemented, scorecard 17/17." --- # Markdown entity and numeric character references diff --git a/docs/FEATURE-MATRIX.md b/docs/FEATURE-MATRIX.md index cc1ec6f..a0afbcf 100644 --- a/docs/FEATURE-MATRIX.md +++ b/docs/FEATURE-MATRIX.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-14T00:00:00Z -summary: Oliver's feature matrix: implemented, planned, and deferred items across the Markdown frontend. +summary: "Oliver's feature matrix: implemented, planned, and deferred items across the Markdown frontend." --- # Oliver Feature Matrix diff --git a/docs/HTML-BLOCKS.md b/docs/HTML-BLOCKS.md index 7995c3b..b98e4f7 100644 --- a/docs/HTML-BLOCKS.md +++ b/docs/HTML-BLOCKS.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-12T00:00:00Z -summary: Contract for Oliver's HTML block handling (section 4.6): all seven types implemented, scorecard 44/44. +summary: "Contract for Oliver's HTML block handling (section 4.6): all seven types implemented, scorecard 44/44." --- # Markdown HTML blocks (§4.6) diff --git a/docs/IMAGES-PARSING.md b/docs/IMAGES-PARSING.md index 905084f..461f28a 100644 --- a/docs/IMAGES-PARSING.md +++ b/docs/IMAGES-PARSING.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-12T00:00:00Z -summary: Contract for the inline-images slice of Oliver's Markdown frontend, derived from CommonMark section 6.7: implemented. +summary: "Contract for the inline-images slice of Oliver's Markdown frontend, derived from CommonMark section 6.7: implemented." --- # Oliver Inline Parsing: Images diff --git a/docs/LEAF-BLOCKS.md b/docs/LEAF-BLOCKS.md index ded2c38..6915a6d 100644 --- a/docs/LEAF-BLOCKS.md +++ b/docs/LEAF-BLOCKS.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-12T00:00:00Z -summary: Implementation contract for CommonMark sections 4.1 and 4.3 leaf blocks: thematic breaks and Setext headings. +summary: "Implementation contract for CommonMark sections 4.1 and 4.3 leaf blocks: thematic breaks and Setext headings." --- # Markdown leaf blocks: thematic breaks and Setext headings diff --git a/docs/RAW-HTML.md b/docs/RAW-HTML.md index 6b2776b..5969d73 100644 --- a/docs/RAW-HTML.md +++ b/docs/RAW-HTML.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-14T00:00:00Z -summary: Contract for the raw HTML slice of Oliver's Markdown frontend (section 6.6): implemented. +summary: "Contract for the raw HTML slice of Oliver's Markdown frontend (section 6.6): implemented." --- # Oliver Inline Parsing: Raw HTML (§6.6) diff --git a/docs/SESSION-1-REPORT.md b/docs/SESSION-1-REPORT.md index ab9ba2a..ee191e8 100644 --- a/docs/SESSION-1-REPORT.md +++ b/docs/SESSION-1-REPORT.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-14T00:00:00Z -summary: The first Oliver session: repository foundation, specification research, feature matrix, document model, and the smallest vertical slice. +summary: "The first Oliver session: repository foundation, specification research, feature matrix, document model, and the smallest vertical slice." --- # Session 1 Report diff --git a/docs/TASK-LISTS.md b/docs/TASK-LISTS.md index 788e545..38fb6df 100644 --- a/docs/TASK-LISTS.md +++ b/docs/TASK-LISTS.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-16T00:00:00Z -summary: The opt-in GFM task list items extension ([ ] / [x] / [X] checkboxes) in the Markdown frontend: shape, recognition rules, chosen behaviors, and rendering. +summary: "The opt-in GFM task list items extension ([ ] / [x] / [X] checkboxes) in the Markdown frontend: shape, recognition rules, chosen behaviors, and rendering." --- # Task lists (extension) diff --git a/docs/TESTS.md b/docs/TESTS.md index d9986c2..ad5fff9 100644 --- a/docs/TESTS.md +++ b/docs/TESTS.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-13T00:00:00Z -summary: Tests are product contracts: zig build test runs six suites covering library modules, fixtures, conformance, CLI parsing, the XHTML profile, and the fuzz wall. +summary: "Tests are product contracts: zig build test runs six suites covering library modules, fixtures, conformance, CLI parsing, the XHTML profile, and the fuzz wall." --- # Oliver tests and fixtures diff --git a/docs/TEXTILE-PARITY.md b/docs/TEXTILE-PARITY.md index aa49f3d..8f506b9 100644 --- a/docs/TEXTILE-PARITY.md +++ b/docs/TEXTILE-PARITY.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-13T00:00:00Z -summary: Textile has no normative corpus, so its quality bar is a fixture audit: the parity audit holds the frontend to documented expectations. +summary: "Textile has no normative corpus, so its quality bar is a fixture audit: the parity audit holds the frontend to documented expectations." --- # Textile parity audit diff --git a/docs/WIKILINKS.md b/docs/WIKILINKS.md index 23d5102..0cac94f 100644 --- a/docs/WIKILINKS.md +++ b/docs/WIKILINKS.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-16T00:00:00Z -summary: The opt-in modular wikilinks extension ([[target]] / [[target|label]]) in the Markdown frontend: shape, precedence, fallbacks, and the resolver policy. +summary: "The opt-in modular wikilinks extension ([[target]] / [[target|label]]) in the Markdown frontend: shape, precedence, fallbacks, and the resolver policy." --- # Wikilinks (extension) diff --git a/docs/XHTML.md b/docs/XHTML.md index d6b0d5e..56df344 100644 --- a/docs/XHTML.md +++ b/docs/XHTML.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-14T00:00:00Z -summary: The XHTML output profile: same normalized IR, same semantics, an XML-compatible serialization, with a fail-closed raw-HTML policy and a mechanical well-formedness gate. +summary: "The XHTML output profile: same normalized IR, same semantics, an XML-compatible serialization, with a fail-closed raw-HTML policy and a mechanical well-formedness gate." --- # XHTML output profile diff --git a/docs/github-pages.md b/docs/github-pages.md index afeb6e7..5cfad5d 100644 --- a/docs/github-pages.md +++ b/docs/github-pages.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-14T00:00:00Z -summary: How Oliver publishes this docs tree to GitHub Pages with a pinned Boris binary: profile, plan, artifact, and audit contracts. +summary: "How Oliver publishes this docs tree to GitHub Pages with a pinned Boris binary: profile, plan, artifact, and audit contracts." --- # GitHub Pages publication diff --git a/docs/index.md b/docs/index.md index 1db3a1c..7991188 100644 --- a/docs/index.md +++ b/docs/index.md @@ -1,6 +1,6 @@ --- published_at: 2026-08-14T00:00:00Z -summary: Oliver documentation home: a small, freestanding markup parsing and rendering library in Zig. +summary: "Oliver documentation home: a small, freestanding markup parsing and rendering library in Zig." --- # Oliver documentation