Docs / Source Data

Every pack should have a
source data sheet.

A pack is easier to trust when people can see who made it, what methodology it uses, what years it covers, when it was updated, and what the important caveats are. This page is the scaffold for that public-facing format.

Why this matters

Source packs should not feel anonymous. Contributors deserve recognition, users need context, and maintainers need a consistent way to explain what is actually inside each pack beyond the raw file tree.

What the sheet should include

This is not runtime metadata. It is the human-readable website-side summary for a pack. It should be visible enough that someone can point to a pack and say, with credibility, “I made that source pack” or “I maintain that source family.”

Recommended fields

  • Pack name and short summary
  • Source owner or maintainer
  • Original publisher or upstream institution
  • Methodology in plain language
  • Last updated date
  • Timeline covered
  • Geographic coverage
  • Main metrics or fields
  • Update cadence
  • Known caveats
  • Contributor credit and pack history
Field What it answers Why users care
Maintainer Who built or currently maintains the pack? Creates recognition, accountability, and contributor ownership.
Methodology How was the source cleaned, merged, transformed, or normalized? Lets users understand whether a pack is direct-source, merged, modeled, or heavily processed.
Last updated When was this pack last refreshed? Freshness is part of trust, especially for hazards and live-ish data.
Timeline covered What years or periods are represented? Prevents confusion between strong historical coverage and current/live coverage.
Coverage Which geographies, hazards, or populations are included? Users need to know whether the pack is global, regional, or highly specific.
Main stats What are the key fields, metrics, or summary values? Helps people quickly decide if a pack is relevant before opening the app.

Example framing

Over time, each maintained pack should have a visible page that reads like a compact dossier: what the pack is, where it came from, what it measures, how current it is, and who made it usable.