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:
1 parent
49f67b2192
commit
88d486b37b
1 file changed
+13
-2
@@ -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).
|
||||||
Reference in new issue
Block a user