Contributor guide

Add a topic

A topic is a canonical economic-impact page (conflict / chokepoint / sanctions / commodity). It is the source of record for its subject.

Steps

  1. Add the subject entity. Add the conflict/chokepoint/sanctions/commodity subject in src/data/entities.ts with a stable slug.
  2. Write the topic. directAnswer (100-150 words), bulletSummary, economicChannels, confidenceNotes, limitations, updateLog, dataMode.
  3. Attach source-linked rows. Add observations/facts for the subject (each via the add-source/add-observation guides).
  4. Wire discovery. It flows into topics index, dashboards, sitemaps, and the graph automatically; add query intents if useful.

Rules

  • Open with a citable direct answer; keep cautious, non-causal language.
  • Label sample rows; do not claim complete coverage.
  • Keep the route static/prerendered.

What not to do

  • Do not create a topic with no citable source-linked content.
  • Do not reference the old game or add AI-attribution language.

Example

A new chokepoint topic with an EIA transit-volume observation and a UNCTAD context fact.

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-topic/data.json.

Other guides