From 903ef755aad4a2f39fa6e6f21fbeaddbabf383a7 Mon Sep 17 00:00:00 2001 From: Sayantan181222 Date: Mon, 7 Sep 2026 23:13:46 +0000 Subject: [PATCH] fix(spec): clarify log.md carries no frontmatter, fix acme_retail example MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit §9 was silent on frontmatter while §8 explicitly forbids it for index.md. The acme_retail reference bundle shipped a log.md with type: Log and title frontmatter, which contradicted the implied rule and was being copied as convention by downstream tools. Add one sentence to §9 mirroring §8, and remove the frontmatter from the reference bundle so spec and example agree. Fixes #286 --- okf/SPEC.md | 4 ++-- okf/bundles/acme_retail/log.md | 5 ----- 2 files changed, 2 insertions(+), 7 deletions(-) diff --git a/okf/SPEC.md b/okf/SPEC.md index c06e3eed..e08d04a7 100644 --- a/okf/SPEC.md +++ b/okf/SPEC.md @@ -533,8 +533,8 @@ MAY synthesize one on the fly when none is present. ## 9. Log files A `log.md` file MAY appear at any level of the hierarchy to record the -history of changes to that scope. The format is a flat list of -date-grouped entries, newest first: +history of changes to that scope. Log files contain no frontmatter. +The format is a flat list of date-grouped entries, newest first: ```markdown # Directory Update Log diff --git a/okf/bundles/acme_retail/log.md b/okf/bundles/acme_retail/log.md index 1f93436b..04913554 100644 --- a/okf/bundles/acme_retail/log.md +++ b/okf/bundles/acme_retail/log.md @@ -1,8 +1,3 @@ ---- -type: Log -title: Acme Retail bundle history ---- - # Bundle history ## 2026-07-01