From 88d486b37bc4b46de23a99f0fd9816772221f786 Mon Sep 17 00:00:00 2001 From: Frank Date: Wed, 21 Oct 2026 02:14:39 -0700 Subject: [PATCH] docs(okf): make the bundle note describe the bundle MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The note in `references/okf-spec.md` claimed the bundle keeps a "`tags` discipline". It does not: 22 of 76 concept pages carry `tags`, and neither `kb-lint.sh` nor `kb-coverage.py` reads that field or `verified` — so the note was a claim about intent that an agent would believe and pay the wrong cost for (adding tags to a page helps no tool, while `verified` silently does the real work: it is the date someone last re-checked the page against the fleet, and its absence means nobody ever has). The note now states the measured usage instead of the aspiration, records the house link style (bundle-absolute, 99 links already written that way), and says plainly that Obsidian `[[wikilinks]]` are not OKF links — with the count this bundle had and the date they were converted. The spec's own repository is now cited under `# Citations`, which the page was missing while it lectured others about skipping citations. Refs #64 --- omp-docs/references/okf-spec.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/omp-docs/references/okf-spec.md b/omp-docs/references/okf-spec.md index 6add03b..d2a69e7 100644 --- a/omp-docs/references/okf-spec.md +++ b/omp-docs/references/okf-spec.md @@ -20,8 +20,13 @@ timestamp: 2026-01-15 > optional trust/lifecycle fields (`verified: { by, at }`, `status`, > `stale_after`) and the `Attested Computation` type, and permits `okf_version:` > frontmatter in a bundle-root `index.md`. This bundle stays on v0.1 semantics -> (kb-lint enforces them); the bundle-local `verified:` date stamp and `tags` -> discipline are producer extensions compatible with both versions. +> (`kb-lint` enforces them). What the optional fields mean HERE, measured 2026-10-21: +> `description` on every concept page; `tags` on 22 of 76 concept pages and no tool reads +> them; `resource` only where the page describes an external thing; `verified: YYYY-MM-DD` +> = "the facts on this page were re-checked against the fleet that day", and a page with no +> `verified` has never been re-checked. House link style is bundle-absolute +> (`/tools/niri/tips.md`) for anything crossing a directory. `[[wikilinks]]` are not OKF +> links — this bundle's 53 of them were converted to markdown links on 2026-10-21. # Open Knowledge Format (OKF) v0.1 @@ -167,3 +172,9 @@ Everything else is soft guidance. Consumers MUST NOT reject a bundle because of - [OKF Bundle Maintenance](okf-maintenance.md) — How to keep your bundle from rotting. - [Root Index](/index.md) — This bundle's structure and navigation. + +# Citations + +- [GoogleCloudPlatform/open-knowledge-format](https://github.com/GoogleCloudPlatform/open-knowledge-format) + — upstream repository: the v0.1 specification this page summarizes and `SPEC.md` for v0.2 + (read 2026-10-19).