Standards and structure

Editorial standards, as a template

Replace this section with your own. It exists because a knowledge hub that does not state its standards is asking readers to trust it on nothing.

• Sourcing. Claims of fact carry a link to a primary source.
• Corrections. Material errors get a dated note at the head of the page.
• Updates. Non-material changes are silent; anything that changes a conclusion gets a note.
• Disclosure. Commercial relationships relevant to a piece appear in it.

How the theme is built

base.html holds the document shell and declares a main block. Every page layout opens with {{#extends "base"}} and fills that block; the header and footer are partials. Page copy is Markdown injected with {{!content}}.

Earlier releases of this theme inlined a 183 KB stylesheet into each of eight layouts — 1.9 MB of duplicated CSS that had already drifted into five different versions. There is now one stylesheet.

Verifying a change

make check parses the token blocks in _layouts/styles.css and asserts every declared pair against its WCAG target in both light and dark: 7:1 for text, 3:1 for borders and the focus ring. A failing token fails the build.