About this site¶
I publish only what I opt in, scan it before it goes out, and trace every number to one reviewed file.
Terms used across these pages are collected in the Glossary.
This is the public edition of a larger, private documentation set. The private set is my working reference for the environment: runbooksAn alert-linked page describing what a rule means and first steps; generated stubs fill gaps without overwriting hand-written pages. Glossary, inventories, decision records and component pages. It has too much detail to publish as it is.
How the public edition is produced¶
- Public pages are written separately. None is produced by filtering a private page.
- A page is staged only if it is listed in the public navigation and marked public. A CI check fails on any mismatch.
- The site is built from the staged pages in a scratch directory.
- A leak testA scan of the built public site, search index included, that fails the build on any finding. Glossary scans everything that would be served: HTML, scripts, XML, the search index and the résumé PDF. Any finding fails the build.
- If the build and the checks pass, the new site replaces the old one. If not, the previous site keeps serving and the scheduled job fails.
Other rules:
- Diagrams are drawn from source with generic labels. There are no screenshots of real consoles.
- Masking is only a second line of defense.
- Every number on a page comes from one reviewed file, with the date it was measured, the period it covers and where it comes from. A check fails the build on any figure that was typed into a page by hand, including a number written out in words.
What is deliberately left out¶
Anything private to the environment or the people around it, and any number I have not approved for publication.
A note on accuracy¶
The pages describe design and practice as of the review date shown on each page. Internal pages carry a stricter status headerThe banner at the top of each page, generated from its front matter, showing the state and the review date (or a short "last reviewed" line on selected pages). Glossary (state, last verified, evidence). This edition shows a plain status and the review date.
Last reviewed Oct 23, 2026