Skip to content
LOKF

Example bundle

examples/acme-knowledge/ is a conformant six-concept reference bundle for a fictional data org. It exercises every headline feature: typed relationships, type-specific fields, authorship, and citations.

examples/acme-knowledge/
├── index.md                          # bundle root: base_iri, context, publisher
├── log.md
├── datasets/events.md                # Dataset
├── tables/user-events.md             # Table with a fields: schema
├── metrics/weekly-active-users.md    # Metric with formula, unit, provenance
├── glossary/active-user.md           # GlossaryTerm with definition
├── playbooks/data-freshness-incident.md  # Playbook
└── services/analytics-api.md         # Service with endpoint

The graph it produces

Section titled “The graph it produces”

Six markdown files, one knowledge graph. Every edge below is a typed frontmatter field, not prose:

graph LR
    WAU["Metric<br/>weekly-active-users"]
    UE["Table<br/>user-events"]
    EV["Dataset<br/>events"]
    AU["GlossaryTerm<br/>active-user"]
    PB["Playbook<br/>data-freshness-incident"]
    API["Service<br/>analytics-api"]

    WAU -- "prov:wasDerivedFrom" --> UE
    WAU -- "dcterms:requires" --> AU
    WAU -- "lokf:measures" --> AU
    UE -- "dcterms:isPartOf" --> EV
    EV -- "schema:hasPart" --> UE
    PB -- "schema:about" --> UE
    PB -- "dcterms:references" --> WAU
    API -- "schema:about" --> WAU

One concept, end to end

Section titled “One concept, end to end”

The bundle’s north-star metric, exactly as committed:

metrics/weekly-active-users.md
---
type: Metric
id: https://acme.example/knowledge/metrics/weekly-active-users
title: Weekly Active Users
description: Distinct users with at least one qualifying event in a trailing 7-day window.
unit: users
formula: COUNT(DISTINCT user_id) over trailing 7 days WHERE event_name IN qualifying_events
resource: https://looker.acme.example/looks/wau
tags: [growth, engagement, north-star]
created: 2026-01-15T09:00:00Z
version: "2.1"
generated: { by: "human:jsmith@acme", at: 2026-06-30T12:00:00Z }
verified:
  - { by: "human:kliu@acme", at: 2026-07-01T16:00:00Z }
  - { by: "process:metrics-nightly", at: 2026-07-02T02:00:00Z }
status: stable
stale_after: 2026-12-31
author:
  - type: Person
    id: https://acme.example/people/jsmith
    name: Jordan Smith
    email: jsmith@acme.example
measures:
  - https://acme.example/knowledge/glossary/active-user
derivedFrom:
  - https://acme.example/knowledge/tables/user-events
dependsOn:
  - https://acme.example/knowledge/glossary/active-user
  - https://acme.example/knowledge/computations/weekly-active-users-count
sources:
  - id: metric-defs-rfc
    resource: https://wiki.acme.example/rfc/metric-defs
    title: Metric definitions RFC
    author: "team:analytics"
    last_modified: 2026-05-12
  - id: wau-look
    resource: https://looker.acme.example/looks/wau
    title: WAU Look (production dashboard)
    author: "team:analytics"
    usage_count: 3200
usage_window: { from: 2026-06-01, to: 2026-06-30 }
---


# Definition


**Weekly Active Users (WAU)** is the count of distinct `user_id`s that produced at
least one [qualifying event](/glossary/active-user.md) during the trailing 7-day
window, computed from [User Events](/tables/user-events.md) by the
[sanctioned WAU computation](/computations/weekly-active-users-count.md).[^metric-defs-rfc]


# Notes


- The window is rolling, not calendar-aligned.
- Internal test accounts are excluded.
- The production figure is served by the WAU Look.[^wau-look]


[^metric-defs-rfc]: Metric definitions RFC
[^wau-look]: WAU Look (production dashboard)

Attach the generated context and expand, and that one file yields these triples (examples/weekly-active-users.nt, committed output of just build):

examples/weekly-active-users.nt
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/dateCreated> "2026-01-15T09:00:00+00:00"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
_:N198f7879bcc84bb3bec94c39942a900c <http://www.w3.org/ns/dcat#startDate> "2026-06-01"^^<http://www.w3.org/2001/XMLSchema#date> .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/url> "https://looker.acme.example/looks/wau"^^<http://www.w3.org/2001/XMLSchema#anyURI> .
_:N198f7879bcc84bb3bec94c39942a900c <http://www.w3.org/ns/dcat#endDate> "2026-06-30"^^<http://www.w3.org/2001/XMLSchema#date> .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/keywords> "growth" .
<https://acme.example/people/jsmith> <http://schema.org/email> "jsmith@acme.example" .
<https://acme.example/knowledge/metrics/weekly-active-users> <https://w3id.org/lokf/measures> <https://acme.example/knowledge/glossary/active-user> .
_:N3dbb433b213249d4aadfaba33e0ffa46 <http://www.w3.org/ns/prov#endedAtTime> "2026-06-30T12:00:00+00:00"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
_:N3dbb433b213249d4aadfaba33e0ffa46 <http://www.w3.org/ns/prov#wasAssociatedWith> "human:jsmith@acme" .
<https://acme.example/knowledge/metric-defs-rfc> <http://schema.org/name> "Metric definitions RFC" .
<https://acme.example/knowledge/metric-defs-rfc> <http://schema.org/url> "https://wiki.acme.example/rfc/metric-defs"^^<http://www.w3.org/2001/XMLSchema#anyURI> .
_:N302c00e0795d4af3a86deabf321f9988 <http://www.w3.org/ns/prov#endedAtTime> "2026-07-02T02:00:00+00:00"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/description> "Distinct users with at least one qualifying event in a trailing 7-day window." .
<https://acme.example/people/jsmith> <http://schema.org/name> "Jordan Smith" .
<https://acme.example/knowledge/metric-defs-rfc> <http://schema.org/dateModified> "2026-05-12"^^<http://www.w3.org/2001/XMLSchema#date> .
_:N302c00e0795d4af3a86deabf321f9988 <http://www.w3.org/ns/prov#wasAssociatedWith> "process:metrics-nightly" .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <https://w3id.org/lokf/Metric> .
<https://acme.example/knowledge/metrics/weekly-active-users> <https://w3id.org/lokf/verified> _:N50f429c2b0a5443da7b7a8c45ce200bb .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/name> "Weekly Active Users" .
<https://acme.example/knowledge/metrics/weekly-active-users> <https://w3id.org/lokf/verified> _:N302c00e0795d4af3a86deabf321f9988 .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/isBasedOn> <https://acme.example/knowledge/metric-defs-rfc> .
<https://acme.example/knowledge/wau-look> <http://schema.org/author> "team:analytics" .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://purl.org/dc/terms/requires> <https://acme.example/knowledge/glossary/active-user> .
<https://acme.example/knowledge/wau-look> <http://schema.org/name> "WAU Look (production dashboard)" .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/author> <https://acme.example/people/jsmith> .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/keywords> "north-star" .
<https://acme.example/knowledge/wau-look> <http://schema.org/url> "https://looker.acme.example/looks/wau"^^<http://www.w3.org/2001/XMLSchema#anyURI> .
<https://acme.example/knowledge/metrics/weekly-active-users> <https://w3id.org/lokf/usageWindow> _:N198f7879bcc84bb3bec94c39942a900c .
<https://acme.example/knowledge/metric-defs-rfc> <http://schema.org/author> "team:analytics" .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://purl.org/dc/terms/requires> <https://acme.example/knowledge/computations/weekly-active-users-count> .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/version> "2.1" .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/isBasedOn> <https://acme.example/knowledge/wau-look> .
<https://acme.example/knowledge/metrics/weekly-active-users> <https://w3id.org/lokf/formula> "COUNT(DISTINCT user_id) over trailing 7 days WHERE event_name IN qualifying_events" .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://www.w3.org/ns/prov#wasGeneratedBy> _:N3dbb433b213249d4aadfaba33e0ffa46 .
<https://acme.example/knowledge/wau-look> <https://w3id.org/lokf/usageCount> "3200"^^<http://www.w3.org/2001/XMLSchema#integer> .
<https://acme.example/people/jsmith> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://schema.org/Person> .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/creativeWorkStatus> "stable" .
_:N50f429c2b0a5443da7b7a8c45ce200bb <http://www.w3.org/ns/prov#endedAtTime> "2026-07-01T16:00:00+00:00"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://www.w3.org/ns/prov#wasDerivedFrom> <https://acme.example/knowledge/tables/user-events> .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/expires> "2026-12-31"^^<http://www.w3.org/2001/XMLSchema#date> .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/unitText> "users" .
<https://acme.example/knowledge/metrics/weekly-active-users> <http://schema.org/keywords> "engagement" .
_:N50f429c2b0a5443da7b7a8c45ce200bb <http://www.w3.org/ns/prov#wasAssociatedWith> "human:kliu@acme" .

Rebuild it yourself

Section titled “Rebuild it yourself”
Terminal window
just build

assembles the bundle (examples/acme-knowledge.bundle.json), validates it against the KnowledgeBundle root — No issues found — and re-emits both RDF projections: examples/acme-knowledge.nt (86 triples for the whole bundle) and examples/weekly-active-users.nt (22 triples for the metric alone).