Skip to content
Craft

Recorded numbers need labels

One change, three different 'after' figures in three places — each one true in its own frame and misleading without it. The fix is labels, not consistency.

Beginner1 min read (computed · recorded 6)updated 2026-09-12numberscopymeasurement

by Motif Editors

revised 2026-09-12First publication in the suggestions-100 backlog batch.

Part 4 of 6 in How a build tells the truthThe rule that had to be firstAuditing the crawl surface

Key takeaways
  • The same change produces different 'after' figures per frame of reference.
  • A figure without its frame is a rumour with a decimal point.
  • Every recorded number on the site names what it measures.

Three afters

A change shipped and three pages printed three numbers: the route's own JavaScript before and after, the total for a cold visit, and the embed's payload. All three were measured, all three moved, and no two agreed — because they measure different things. The label is what makes a number true.

The convention

Every before/after pair on this site now names its frame: 'JS on a component detail page', 'JS on a route that renders no demo'. The changelog entry is the contract, the build report is the evidence, and the harness holds the pair together.

Practise the lesson

Theory sticks when you ship it. These original Motif assets put this guide's lesson to work — open one and copy it into your own page.