// SPDX-License-Identifier: CC-BY-SA-4.0
// SPDX-FileCopyrightText: 2026 Jonathan D.A. Jewell (hyperpolymath)
= Standards Wiki — the education layer
:toc:
:toc-placement: preamble
:status: Scaffold v0.1.0 (2026-06-21)

This directory is the **long-form, audience-segmented education layer** for
`hyperpolymath/standards`. It is deliberately *deeper* than the
`QUICKSTART-*.adoc` files: those get you set up and running; these explain the
*why*, the model, and how to engage with the materials fully.

[IMPORTANT]
====
*Status: scaffold.* This is a starting skeleton (standards#docs-wiki-audit).
Each track below has a structured learning path and links to the canonical
sources, with `TODO` markers where prose still needs writing. It is honest
about being incomplete — contributions fill the gaps, they do not start from
zero.
====

== The two front doors (unchanged)

The wiki does not replace the canonical front doors — it *teaches* them:

* Human front door: `README.adoc`
* Machine front door: `0-AI-MANIFEST.a2ml`
* Verifiable index of every spec: `.machine_readable/REGISTRY.a2ml`

== Tracks by audience

[cols="1,3,1",options="header"]
|===
| Track | For whom | Start

| link:users/index.adoc[Users]
| People *consuming / adopting* the standards in their own repos — reusable
  workflows, A2ML artefacts, the policies, the readiness grades.
| link:../../QUICKSTART-USER.adoc[QUICKSTART-USER]

| link:developers/index.adoc[Developers]
| People *building to* the standards, or extending the tooling — language
  policy, A2ML/K9 authoring, Hypatia rules, the CI gates.
| link:../../QUICKSTART-DEV.adoc[QUICKSTART-DEV]

| link:maintainers/index.adoc[Maintainers]
| People *evolving* this repo — the registry generator, the guardrails, the
  licence policy, the drift/staleness automation, the innervation stack.
| link:../../QUICKSTART-MAINTAINER.adoc[QUICKSTART-MAINTAINER]
|===

== Format & sync rules

* Primary format is **AsciiDoc (`.adoc`)** (estate doc policy; no `.md`
  duplicates).
* The machine mirror of this track is `0.2-AI-MANIFEST.a2ml` in this
  directory — keep it in step when tracks are added.
* If/when a forge-hosted wiki (GitHub/GitLab) is adopted, this directory is
  the source of truth and is synced *out* to the forge, never hand-edited
  there. (Mirrors the estate pattern in `k9-svc/*/docs/wikis/`.)

== TODO (scaffold → complete)

* [ ] Flesh out each track's "core concepts" prose beyond the link lists.
* [ ] Decide forge-wiki vs in-repo-only hosting.
* [ ] Add a "glossary" page (A2ML, K9, RSR, CRG, contractile, innervation, 6a2).
* [ ] Add worked examples per track (adopt a repo / write a rule / cut a change).
