docs(okf): make the bundle note describe the bundle

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
This commit is contained in:
Frank committed 2026-10-21 02:14:39 -07:00
1 parent 49f67b2192
commit 88d486b37b
1 file changed
+13 -2
+13 -2
View File
@@ -20,8 +20,13 @@ timestamp: 2026-01-15
> optional trust/lifecycle fields (`verified: { by, at }`, `status`, > optional trust/lifecycle fields (`verified: { by, at }`, `status`,
> `stale_after`) and the `Attested Computation` type, and permits `okf_version:` > `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 > 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` > (`kb-lint` enforces them). What the optional fields mean HERE, measured 2026-10-21:
> discipline are producer extensions compatible with both versions. > `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 # 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. - [OKF Bundle Maintenance](okf-maintenance.md) — How to keep your bundle from rotting.
- [Root Index](/index.md) — This bundle's structure and navigation. - [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).