Section

Reference

Look-up material — frontmatter fields, repository inventory, file formats, glossary, changelog.

10 pages in this section

Reference pages are flat catalogues: lookup-oriented, not narrative. Open them when you know what you’re looking for and want the canonical answer fast.

If you’re trying to understand something rather than look it up, you probably want Architecture or one of the Contributing sections instead.

What lives here#

  • Frontmatter Reference — every TOML field that may appear in any content file. Universal fields, per-content-type fields, taxonomies, templates, four worked examples covering each content type.
  • Library Book Format — the JSON schema for books in data-library. Per-chapter format, paragraph refIds (TBWTT-1:5), i18n slots, speaker types.
  • Repository Inventory — every repository in the wheelofheaven org. What it is, what’s in it, the GitHub URL.
  • Glossary — project-internal terms (Bifrost, claim type, editorial pass, refId, OG card, etc.). Distinct from the on-site translations glossary in data-content/i18n/glossary.json.
  • Icon Registry — every icon used on www.wheelofheaven.world, rendered live from data/icons.json. Slug bindings (section / tradition / event-type), family classification (stroked / mixed / filled), source, viewBox, and usage.
  • Changelog — major project milestones (domain migration, editorial passes, infrastructure shifts) at a project level. Not commit history.

How these stay current#

Reference pages are kept in sync by hand. If you change something — add a new frontmatter field, rename a repo, retire a content type — update the relevant reference page in the same PR.

  • API Reference Tabular reference for api.wheelofheaven.world — endpoint catalogue, response envelope, controlled vocabularies, JSON Schemas, language routing, and changelog.
  • Frontmatter Reference Every TOML field that may appear in content frontmatter — what it means, where it's used, and per-content-type defaults.
  • Library Book Format JSON schema for books in data-library — split-chapter layout, paragraph refIds, and i18n slots.
  • Repository Inventory Every repository in the Wheel of Heaven GitHub organization — what it is, where it lives, and what depends on what.
  • MCP Server The Wheel of Heaven MCP server — connect AI agents to the corpus via Model Context Protocol: 9 read-only tools with claim-type labels and an explicit fact/interpretation split.
  • Datasets The downloadable CC0 datasets published from the corpus — the content-graph, its formats, API endpoints, and the /datasets/ landing pages.
  • Retrieval Benchmark How Wheel of Heaven measures AI information penetration — the quarterly benchmark of whether the corpus appears in AI answers' retrieval and citation chains.
  • Glossary Internal terms used across the docs and codebase — Bifrost, claim type, editorial pass, refId, etc.
  • Icon registry Every icon used across www.wheelofheaven.world, rendered live from data/icons.json — slug bindings, family classification, full catalogue.
  • Changelog Major project milestones — domain migrations, framework decisions, editorial passes.

Edit this page on GitHub