Governance
- 15.1 Source of truth
- 15.2 Naming
- 15.3 Versioning
- 15.4 Change process
- 15.5 Review checklist
- 15.6 Defect classes
- 15.7 Open items
- 15.8 Changelog
15.1 Source of truth
tokens/tokens.json (W3C design-token format) is the source. tokens.css, color_math.json, print.csv and palette.html are generated by color_system.py from tokens/color-input.json and tokens/extra.json; they are never edited by hand. Templates are generated by templates/build_templates.py. This document is generated by docs_src/build_doc.py.
15.2 Naming
--mfp-<category>-<concept>-<variant>. Components use the role and alias tokens (--mfp-text-secondary, --mfp-alias-band), not raw ramp steps, except in charts.
15.3 Versioning
Major: a core colour, typeface or the logo changes. Minor: tokens or surfaces are added. Patch: corrections.
15.4 Change process
Propose the change with the surface it fixes → check it against the five laws → change the token or template source → regenerate → run qa_check.py → note it in the changelog.
15.5 Review checklist
- It answers one question.
- Ladder rungs in order; every number has a unit and a basis tag.
- One terracotta action per view.
- Tokens only; spacing on the 4 px grid.
- Contrast pairs from the matrix.
- Alt text on every image; concept renders labelled.
- Keyboard, focus, reduced motion, 200% zoom, 320 px checked.
- Logo from the SVG, right colourway, clear space kept.
- No avoided words; canonical lines untouched.
15.6 Defect classes
Blocking: contrast failure; status by colour alone; a number without a basis on a published surface; a concept render presented as a real job; "licensed" without a number. Major: off-token colour; a second terracotta element; a redrawn or misspelt logo. Minor: casing slips; one off-grid value.
15.7 Open items
| # | Item | Needed from |
|---|---|---|
| 1 | Sign-off on the redrawn logo | Owner |
| 2 | Founding year ("Est. 2008" on the old badge) | Owner |
| 3 | Review count with a linked platform | Owner |
| 4 | One sourced project count (the site shows both 500+ and 2,500+) | Owner |
| 5 | Phone number: (725) is a Nevada area code; consider a 214, 469 or 972 number | Owner |
| 6 | Certificate of insurance and screening provider on file, to support the "On file" tags | Owner |
| 7 | Postal address for the email footer | Owner |
| 8 | Social handles | Owner |
| 9 | Vinyl and thread reference numbers, confirmed on physical swatches | Sign shop, embroiderer |
| 10 | Real photography to replace concept renders | Photographer |
| 11 | The local repository uses navy #1B2A46, orange #FF6B35 and Inter; this system follows the live site instead |
Developer |
| 12 | Icons to refine in v1.1: hammer, shelf, trim | Designer |
| 13 | Technicians in the renders are not varied enough; widen in the next batch | Designer |
15.8 Changelog
- v1.0 · 2026-11-16 First version. Measured from the live site; brief confirmed by the owner; logo redrawn; 72 icons; 39 concept renders; 32 templates.