From 2d2cd1a6469e2bd343d8489eb24a0a39eca77ccb Mon Sep 17 00:00:00 2001 From: Adarsh Singh Date: Thu, 10 Sep 2026 16:16:36 +0530 Subject: [PATCH 1/2] =?UTF-8?q?docs(spec):=20clarify=20that=20leading-slas?= =?UTF-8?q?h=20paths=20are=20relative=20to=20bundle=20root=20in=20=C2=A76.?= =?UTF-8?q?2?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- okf/SPEC.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/okf/SPEC.md b/okf/SPEC.md index c06e3eed..09d3786a 100644 --- a/okf/SPEC.md +++ b/okf/SPEC.md @@ -473,7 +473,7 @@ Several fields name a path or URI: `resource`, `sources[].resource`, case it is not a path. Each path-valued field accepts: - an absolute URL (for example `https://...`), -- a bundle-relative path beginning with `/`, or +- a bundle-relative path beginning with `/` (interpreted relative to the bundle root directory, not the filesystem or host domain root), or - a relative path (for example `../computations/revenue.md`). ### 6.3 The `references/` convention From fe89bf8195301562b33973e4e92473697fe9f750 Mon Sep 17 00:00:00 2001 From: Adarsh Singh Date: Thu, 10 Sep 2026 18:28:38 +0530 Subject: [PATCH 2/2] docs: add Ecosystem & Showcase section to README for OKF implementations --- okf/README.md | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/okf/README.md b/okf/README.md index 53ae20f3..d50bedd6 100644 --- a/okf/README.md +++ b/okf/README.md @@ -225,8 +225,23 @@ The HTML embeds the bundle as a JSON blob and uses both loaded from a CDN. No data leaves the page; the bundle is parsed once at generation time and serialized into the file. +## Ecosystem & Showcase + +OKF is a universal, vendor-neutral format designed for broad interoperability across tools, agents, and human interfaces. + +### Community Tools & Integrations + +- **Interactive Graph Visualizer** — Self-contained HTML viewer using Cytoscape.js and Marked.js (bundled in this repo). +- **[okf-guard](https://github.com/GoogleCloudPlatform/open-knowledge-format)** — Integrity validator and linter for OKF bundles to enforce structural and schema consistency. +- **Knowledge Management Tooling** — Native compatibility with Obsidian, MkDocs, Notion, Hugo, and Jekyll for browsing and editing OKF bundles. + +### Listing Your Project + +Have you built an agent, exporter, linter, or visualization tool for OKF? We welcome additions! Open a pull request to add your project to this list. + ## Tests ``` .venv/bin/pytest ``` +