Files
ai-resume/content/history/l3/history-code-exhibits.md
Documenter 286aa12bb0 site: cut the template's own labels out of the pages
Point 7 of the page-wording review. The pages no longer show their data
structure as headings, and they no longer explain their own conventions.

- Level 1 is one screen: claim, status badge, three figures, the technology
  row, and one sentence carrying one link. Measured in headless Chrome at
  1440x900: 1404-1845 px tall before, exactly 900 px (no scroll) after, on
  all six area pages.
- DocPage: no kicker line, no visible level label, no "Evidence for this
  page" heading or instruction note, no "Drill-downs" list, no
  "Status <word> - sentence" footer. The artefact table starts at level 2,
  under the heading "Artefacts"; the history timeline is level 2 only.
- Landing page: "Start here" link text gone, "How to read this site" panel
  gone, the footer's status-label explainer gone.
- Content, presentation only, no claim softened: the leading H1 that
  duplicated the page title removed from all 41 documents; level 1 bodies
  reduced to the constraint as ordinary prose plus the way in;
  "**Status: ...**" prefixes removed from the artefact stubs; "## Drill-downs"
  and "## Period and confidence" removed from the level 2 pages, with the
  cross-area links moved into the prose.
- The six level 1 claims are now sentences with a subject, and use commas
  instead of middots. Same facts, no new ones.

Not in this commit: the 35 level 2 and 3 claims still use the compact CV
style. That is a voice decision for Sam, not a wording tidy-up.

make validate: 41 documents, 0 violations. go test ./...: pass.

(cherry picked from commit 03009f80fc7815ad7719412e125df9297a6e653f)
2026-10-28 15:55:33 +11:00

2.1 KiB
Raw Blame History

id, area, level, title, claim, confidence, period, tech, metrics, artefacts, public, last_verified, tags
id area level title claim confidence period tech metrics artefacts public last_verified tags
history-code-exhibits history 3 Artefact — Six code exhibits across five eras Six short excerpts spanning object-oriented ActionScript · a hand-written JavaScript animation engine · a PHP media pipeline · typed TypeScript · embedded C++ · and declarative Nix. historic 2006–2026
ActionScript
JavaScript
PHP
TypeScript
C++
Nix
label value
code exhibits 6
label value
technology eras spanned 5
true 2026-10-26
history
code
exhibits
artefact

The excerpts are selected from source that exists on disk; each one lands in Phase 7 with two sentences on why it is good code.

The six

# Era Source What the excerpt shows
1 Object-oriented ActionScript the brief-case builder and the national beer campaign class design, imports, encapsulation
2 Hand-written JavaScript engine the text-effects engine from the site builder (about 2 200 lines) easing and a timeline core
3 PHP media pipeline the media encoder from the site builder (about 3 400 lines) one encode operation and the FFmpeg piping around it
4 TypeScript the vehicle-tracking application's schema and typed service layer types, interfaces, a router
5 Embedded C++ the Wi-Fi manager interface and implementation interface versus implementation in firmware
6 Declarative infrastructure the 25-line Nix package definition pinned version, verified hash, written exit condition

Total is roughly 225 lines across twenty years, which is the point: each excerpt is chosen to show judgement rather than volume.

What it proves

That the stack changed six times and the discipline did not. Exhibit 6 is the least common of the six and the most current — a short, correct, self-documenting derivation with an exit plan is a stronger infrastructure signal than a long configuration file.

When it is delivered

Phase 7. Source paths are recorded in the planning notes; nothing is published from a path that has not been read at capture time.