Warconomy
Contributor guide

Add a source

A source is the publisher of record behind a value. Sources are the gate: no observation is added before its source is.

Steps

  1. Confirm authority. Prefer official/intergovernmental publishers; authoritative research (e.g. CREA, KSE) is medium confidence. Avoid news, blogs, social posts, and AI summaries as source of record.
  2. Capture a deep link. Link the specific page/series, not a homepage; record an accessedDate.
  3. Set cadence. monthly / annual / unknown — this drives freshness and review thresholds.
  4. Add the Source record. id, title, publisher, url, type, cadence, accessedDate, optional tags/note in src/data/sources.ts.

Rules

  • Every source must have a resolvable URL and an accessedDate.
  • Do not use paywalled/inaccessible charts as source of record.
  • Citation readiness is derived (authority + role + how directly it backs a value) — not hand-scored.

What not to do

  • Do not add a source you cannot open and verify.
  • Do not treat a news article as the source of record for a live value.

Example

EIA Brent spot price series page → type 'official', cadence 'monthly', accessedDate set.

No scraping, scheduled jobs, runtime APIs, or real-time claims. See the methodology, the developer guide, and the data needs backlog. Machine-readable: /methodology/add-source/data.json.

Other guides