Autumn Sale: 20% off almost everything until 24 DecemberSee the sale →
See all 402 products Free UK delivery over £35
Wiki entry · 3 min read

Single source of truth: the truth spine and information drift

A single source of truth is the agreed authoritative record for a fact. Instead of typing that fact into several places and hoping the copies stay in step, other parts of the system read from that record.

Published Curator-written, not crowdsourced
04 / Sections · Tea Wiki

A single source of truth is the agreed authoritative record for a fact. Instead of typing that fact into several places and hoping the copies stay in step, other parts of the system read from that record.

Why a tea shop cares: one record for each tea means the product page, the search result and the assistant all quote the same price.

At teas.co.uk, Lee calls the arrangement the truth spine. Imagine one reliable ledger behind several shop windows. The windows may look different, but a price shown in each should come from the same entry.

One source does not mean one enormous document

A product record can own a product's pack size. The shop's stock system can own its availability. A maintained policy can own the delivery rules. The point is to decide which source is responsible for each fact and have every presentation use it consistently.

The Tea Wiki still needs explanatory writing, and recipes still need their own instructions. Connecting them to a product does not turn every sentence into a product field. It lets each kind of information be maintained in the right place.

What is drift?

Information drifts when its versions disagree. A product page might show a new price while a comparison table still contains last month's price. A machine-readable export might describe a product that has left the range.

Some drift comes from independent edits. Some comes from timing. A cache is a saved copy used to answer quickly; a feed is a published collection of records. Both may need refreshing after the underlying information changes.

What should stay the same?

For the same product and the same effective time, a human page and a machine response should agree on shared facts such as identity, pack size and currency. Price and stock also need a freshness check because they can change.

The formats need not look identical. Structured data can label a value; a paragraph can explain it. Parity means the relevant facts agree, not that the page and the response contain identical words or every possible field.

A canonical URL is the preferred web address for a page. Google's canonical URL guidance explains how websites signal that preference. Choosing an address helps identify the page; it does not synchronise prices or validate its claims.

The checks are part of the system

Keep sources and review dates, refresh dependent outputs, and compare representative records after a change. Investigate differences before promising that every output agrees. A shared source can distribute an incorrect value just as efficiently as a correct one.

The shop describes its public evidence in Under the Hood. The truth entity idea includes this continuing maintenance, and route hygiene covers keeping the links to those facts accurate.

Download as PDF

Got something to add? Logged-in customers can submit additions to the Tea Wiki, admin-approved, your name on the byline, plus reward points.

Sign in to contribute
Tea notes and stock updates

Useful tea notes, only when there is something to say.

Stock arrivals, buying notes and practical guidance from the catalogue. No filler, no daily noise, unsubscribe in one click.

By family

By moment

Brand of the monthHyson Seasonal taster packsHow the seasonal bundles work Tea of the Month ClubCurator-picked monthly box Find your tea60-second quiz 0 Basket £0.00
See all 402 products