Help · eight sections · a five-minute read

How to use this

Reading the colours and the fields, finding things, and keeping what you want.

Every entry in the ledger is dated, attributed, graded for the kind of claim it is, and given a worked case and two examples of it in practice. This page explains how to read that, and where everything lives.

IWhere things are

The home page is a feed: the whole ledger in one pass. Every entry also has a page of its own with everything recorded about it, and the A to Z lists them all. The subjects page leads to the subject pages, which are readings rather than instruments: one subject at full length, grouped by register, with no controls to work. Search is the instrument, and Reading holds the full definition of an empiriceme, the essay What is empiricalism?, Mill’s Handle and the thought experiments.

If the ledger is missing something, suggest an entry. No account or email address is needed, and every suggestion is checked before anything is added.

Any entry can be linked to directly. empiriceme/goodharts-law.html is its own page, which is the address to share. Links made to the old ledger, such as ledger.html#goodharts-law, still work and arrive at the same page.

IIRegister: the colour on every entry

Register is the one thing this ledger insists on. Many entries here are adages, analogies or paradoxes, and cannot be true or false in the way a measured regularity can. The colour tells you which you are looking at before you read a word.

Evidence · A claim about the world that data can bear on: measured regularities, documented biases, proved theorems.
Model · An explanatory account or formal model. Judged by whether it organises the phenomenon, not by a single test.
Precept · A statement of how one ought to act or design: normative principles, razors, and pre-modern maxims.
Figure · A saying, an image or a puzzle. Carries insight but is not the kind of thing that can be false.

IIIType: the finer distinction

Within each register, the type names the kind of claim precisely. Narrowing a search by type is the fastest way to separate what can be tested from what cannot.

TypeMeaningEntries
Empirical RegularityA pattern claimed to hold in data.
TheoremA formally proved result.
Bias / EffectA documented deviation in judgement or perception.
Theory / ModelAn explanatory account or formal model.
Normative PrincipleA statement of how one ought to act or design.
Heuristic / RazorA rule of thumb for choosing between explanations or actions.
Canon / MaximA pre-modern legal or political maxim about institutional behaviour.
Adage / Folk LawA witticism or maxim, often untestable. Kept for its currency, not its evidence.
Analogy / MetaphorBorrowed from another domain; the transfer is illustrative, not derived.
ParadoxA result that conflicts with intuition or with itself.

IVWhat each entry contains

Every entry’s page carries the same fields in the same order. The distinction between the worked case and the examples is the useful one: the worked case is where the claim came from, and the examples are where it turns up.

FieldWhat it holds
LawCanonical name. Eponyms take apostrophe-s; multi-author names take an en dash.
Type & SubjectShown above the name on its page, and on every card.
DefinitionOne sentence, phrased so the claim can be judged true or false.
Worked caseProvenance: the study, the incident or the number the claim rests on.
In practiceTwo applied examples, written for this ledger. Where the subject allows, one is institutional and one everyday.
Attributed toOriginator where identifiable. “Unattributed” means no source was traceable, which is itself worth knowing.
CircaYear or era of first clear statement. “c.” marks an estimate.
Also calledAlternative and cross-domain names. Many entries are better known under a name other than the canonical one.
StandingContested status, replication caveats, misattributions and lineage. Blank where none apply.
Possible explanationsWhy the pattern might occur, where accounts have been offered. Several are given where they compete.
In its favourThe case for the claim’s usefulness and validity, as its supporters and the evidence make it.
Against itThe case its critics and the contrary evidence make. The ledger reports both sides and does not rule between them.
FlagsTwo, shown beside the name. contested marks a live dispute. in jest marks an entry written tongue-in-cheek, which is never offered as evidence of anything.

VContested entries

Where a claim is disputed, has failed replication, or is misattributed, the entry says so rather than leaving it out. The dispute is recorded in Standing, and the two examples underneath still show the pattern the claim describes — a reader who cannot see what is being claimed has no way to judge whether it holds.

The contested tag appears beside the entry name, every card in the feed says in one line why, and the Standing control on the search page isolates the entries whose notes record a dispute. It is worth browsing those on their own: the errors are frequently more instructive than the confirmations. Hawthorne, Stanford Prison, Lady Macbeth, social priming, growth mindset and the backfire effect are all here with their replication histories attached.

Political claims are included across the spectrum on the same terms, each with its standing stated. Where two traditions make mirror-image claims, the notes point from one to the other.

A small number of entries are written in jest and carry the in jest flag. They are mock-serious: the form is the ledger’s and the content is a joke, usually about a real pattern that has a duller name elsewhere. The Standing control will show only these or leave them out, and the flag is on the card so nobody meets one unawares.

VIThe feed

The home page runs through every entry once, in an order meant to be worth reading from the top. Each entry is placed in advance in one of three tiers by how widely it is known, judged first from a year of Wikipedia readership and then by hand, and the funny ones are marked separately. The feed deals them in fives: two of the best known, one of the funny ones, one from the middle, and one obscure. So the famous and the funny come first, and no five go by without something you are unlikely to have met.

The order is drawn from the date, so every reader sees the same opening on the same day, and the first card is the day’s entry. A reload picks up where you were. Shuffle in the top bar deals you a private order, and Today’s order puts the shared one back. When the run is finished it says so, rather than starting again without telling you.

VIISearch

Search covers the name, every other name, the thinker and the definition, and once you start typing it adds the worked case and both examples. That makes it forgiving: Kitty Genovese reaches the bystander effect, Hanoi reaches the cobra effect, Katy Freeway reaches induced demand, Concorde reaches the sunk cost fallacy, and bikeshedding reaches Parkinson. Every word you type has to match somewhere, and a match in a name counts for most.

With nothing typed, search lists every entry alphabetically, narrowed by whatever you have chosen. The address changes as you go, so any search can be bookmarked or sent, and each subject page links to search with its subject already chosen.

The strip on the subjects page is a half-century histogram. It reads as a long flat plain from 500 BC and then a cliff at 1950, which is the honest shape of the record rather than a design choice.

VIIIFavourites

Tap the star on any card or entry page to keep it. The entry lights gold, and it shows as starred everywhere else it appears.

Favourites are saved in this browser’s own storage rather than in a cookie. No identifier is written, and unlike a cookie this store is never transmitted with a request, so nothing about what you have kept leaves the device. The record is a fixed characters whether you star a single entry or every one of them, which is why adding to the ledger never disturbs what you have saved.

Stars are shared across the whole site: the feed, the subject pages, the entry pages and search all read the same record, and two tabs open at once stay in step with each other.

To see only what you have kept, choose Starred only on the search page. To move favourites to another browser, open Back up or restore my favourites at the foot of the search page, copy the text and paste it there. If your browser blocks site storage the stars still work for the visit; that panel will tell you, so you can copy the text before closing the page.

For what the ledger is for, why it is graded this way, and what an empiriceme is, read What is empiricalism? Otherwise, start with the feed.