---
title: "Decisions"
url: /decisions
description: "The numbered decisions this site follows, with the check that enforces each one. Rules that nothing checks yet are marked as gaps."
---

## §0 · register

# Decisions

This site follows its own method. These are the 16 rules of this website, not general advice. Each rule names the check in the repository that enforces it. Where nothing checks a rule, the cell says `not enforced (gap)`. A script fails the build when a cell is empty.

The footer of every page counts how many of these are enforced. That count comes from the checks, not from this page.

### What the footer line means

| Item | Meaning |
|---|---|
| commit | The version of the code that the page comes from. |
| site rules enforced | How many of the 16 rules of this website have a check that runs at each build. |
| raw values | Colors, sizes or fonts written directly in the code instead of taken from a token. The target is 0. |
| unknown claims | Numbers on the site that are not in the [claims registry](/claims.json) with a source. The target is 0. |
| contrast | Brand and mode combinations where all text meets the WCAG contrast of 4.5:1. The site has four.

| Id | Rule | Why | Rejected | Enforced by |
|---|---|---|---|---|
| D-01 | Components take colour, space, radius and size from tokens only | Brand is a parameter. One raw value breaks the switch | Per-brand component variants | check:raw-values |
| D-02 | Every figure on the site is a Claim referenced by id, with a base and a source | No number without its base | Figures typed into prose | check:claims |
| D-03 | Text contrast is at least 4.5:1 for every text and background token pair in all four permutations | Both brands must pass, or the switch proves nothing | Checking the main brand only | check:contrast |
| D-04 | Every decision has "Enforced by" or the literal "not enforced (gap)" | An empty cell hides a gap | An optional column | check:decisions |
| D-05 | Tokens are DTCG 2025.10 files with one resolver and two modifiers, brand and mode | The repository is the source of truth; the design tool is a view | Tokens edited in the design tool | check:tokens (tz check, tz lint) |
| D-06 | No cookies and no third-party requests; fonts are self-hosted | Privacy without a cookie bar | Web fonts from a CDN; analytics with cookies | check:third-party |
| D-07 | Every content page has a Markdown twin at the same address plus .md | A person and an agent read the same facts | A separate agent API | check:twins |
| D-08 | Generated files start with a marker that names the script and are never edited by hand | A hand edit is overwritten and hides drift | Committed hand-tuned output | check:generated (CI regenerates and diffs) |
| D-09 | No broken internal link | A dead link on the talk page costs the audience | Checking links by hand before launch | check:links |
| D-10 | A "Today against demo" row older than 90 days is marked stale | A dated claim rots | Undated rows | check:stale |
| D-11 | 2026 work is named only in the neutral wording of the naming register | Confidentiality agreed with the owner | Client names in text, files or commits | check:blocklist (list kept outside the repository) |
| D-12 | Site copy follows the voice mechanics: no em dash, no exclamation mark, no "we", no contractions | One person speaking, without the generated-text tells | Review by eye only | check:voice |
| D-13 | Status uses lightness, glyph and word, never hue alone | Colour alone fails some readers | Red and green status by hue | not enforced (gap) |
| D-14 | Brand and mode come from the address, then the system preference; the choice is never stored | Nothing to consent to | A cookie or local storage | not enforced (gap) |
| D-15 | A card's accent rule sits on top, never on the left | Avoid the look of generated sites | Left-border callouts | not enforced (gap) |
| D-16 | On a phone every table scrolls inside its box, the first column stays fixed and a hatched edge shows there is more | The content is tables; stacking breaks the comparison across columns | Stacked cards per row; shrinking text to fit | not enforced (gap) |

## §1 · use it

### Copy the shape

The register is also served as JSON at [/decisions.json](/decisions.json). The columns are the ones I used on three projects: Rule, Why, Rejected, Enforced by. The pattern behind it: [Enforced by](/patterns/enforced-by).
