# SPDX-License-Identifier: MPL-2.0
# SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath) <j.d.a.jewell@open.ac.uk>
#
# Machine pointer for the standards education layer (the wiki track).
# Human entry: docs/wikis/README.adoc. This file mirrors that structure so an
# agent can route a "teach me X for audience Y" request without scraping prose.

id: "wikis-track"
status: "scaffold"
version: "0.1.0"
updated: "2026-06-21"

description: >
  Audience-segmented, long-form education layer for hyperpolymath/standards.
  Deeper than the QUICKSTART-*.adoc files (which cover setup + basic run): the
  wiki teaches the model, the why, and how to engage fully.

format:
  primary: "asciidoc"          # estate doc policy; no .md duplicates
  source_of_truth: "in-repo"   # synced OUT to any forge wiki, never hand-edited there

front_doors:
  human: "README.adoc"
  machine: "0-AI-MANIFEST.a2ml"
  verifiable_index: ".machine_readable/REGISTRY.a2ml"

tracks:
  - audience: "users"
    home: "docs/wikis/users/index.adoc"
    quickstart: "QUICKSTART-USER.adoc"
    for: "consuming / adopting the standards (reusable workflows, A2ML, grades)"
  - audience: "developers"
    home: "docs/wikis/developers/index.adoc"
    quickstart: "QUICKSTART-DEV.adoc"
    for: "building to the standards; authoring A2ML/K9; writing Hypatia rules"
  - audience: "maintainers"
    home: "docs/wikis/maintainers/index.adoc"
    quickstart: "QUICKSTART-MAINTAINER.adoc"
    for: "evolving the standards: registry generator, guardrails, drift automation"

todo:
  - "Flesh out per-track core-concept prose beyond the link spine"
  - "Decide forge-wiki vs in-repo-only hosting"
  - "Add glossary + per-track worked examples"
