quoin

The Quoin specification

The constitution, the specification and its changelog, in reading order.

  1. About the specification

    What Quoin is, why it exists, and the order to read the documents in.

  2. The Quoin Constitution

    The ten invariants that hold across every site, every implementation and every revision.

  3. Quoin Glossary

    The vocabulary. Terms are used precisely throughout the specification.

  4. Spec 00 — Overview

    The four-layer model, conformance language, scope and versioning.

  5. Spec 01 — Site Model

    What a site is: pages, page types, blocks, menus, references, tokens, themes and derived data.

  6. Spec 02 — Content Schema

    The strict schemas for page types, blocks, menus, site configuration, media and featured content.

  7. Spec 03 — Authoring Pipeline

    How a change is made, from an email arriving to a pull request and a reply.

  8. Spec 04 — Review, Approval, and the Trust Dial

    Two-level approval, the nonce, the trust dial and the audit record.

  9. Spec 05 — Delivery

    The static output contract, environments, previews, publishing, hosting and backups.

  10. Spec 06 — Security

    The threat model and its controls: sender identity, approval binding, credentials, secrets and incidents.

  11. Spec 07 — Conformance

    What makes a site a Quoin site, the conformance checklist and levels.

  12. Spec 08 — Tooling: the normative tool surface

    The enforced loop and the tools that apply the rules mechanically.

  13. Changelog

    Every change to the specification, with its impact class and what implementers must do.