From e895a5e5f24fbde3526549bbbd3ab611ed5696a3 Mon Sep 17 00:00:00 2001 From: manumishra12 Date: Sat, 11 Jul 2026 14:26:33 -0700 Subject: [PATCH] okf: state that log.md is append-only history (SPEC 7) Section 7 describes log.md as a history of changes but did not say whether past entries may be edited. Adds a sentence: entries are append-only; producers SHOULD add new dated entries and record corrections as superseding entries rather than rewriting past ones. Additive and backward-compatible. Addresses #89. --- okf/SPEC.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/okf/SPEC.md b/okf/SPEC.md index 55d0a46c..873a65e2 100644 --- a/okf/SPEC.md +++ b/okf/SPEC.md @@ -317,6 +317,11 @@ Date headings MUST use ISO 8601 `YYYY-MM-DD` form. Log entries are prose; the leading bold word (`**Update**`, `**Creation**`, `**Deprecation**`, etc.) is a convention, not a requirement. +Log entries are append-only: producers SHOULD add new dated entries rather +than editing or deleting past ones, so the log remains a faithful history. A +correction SHOULD be recorded as a new entry that supersedes the earlier +statement, not as a rewrite of it. + --- ## 8. Citations