About · sources, validation, colophon
What this is
A basketball analytics research log. Every surface is descriptive and labeled; every model claim was pre-registered and judged on fixed gates — the failures are on the reads index next to the passes. Metric definitions live in the canon.
Sources & credit
- ESPN — the box-score spine: game scores, player boxes, shot locations.
- balldontlie — the second source: advanced tracking tiers (matchups, contested shots, box outs, rebound chances, touches/passes), contracts, standings, play-by-play. Public surfaces carry balldontlie numbers only while a subscription is active.
- LUMA Basketball Research (ARC v3.1, LOKI v3.3) — external benchmark credit for every model read; never republished.
Validation
Nothing from a new source renders until it agrees with the spine exactly. The gate: game scores and player boxes on the overlapping season must match to the point — 688/688 exact game scores 2024-25 and 324 boxes matched LUMA Basketball Research (ARC v3.1, LOKI v3.3) exactly. Field note from the build: balldontlie season keys are starting years and ESPN's are ending years — every merge in the pipeline pins site-season = source-season + 1, after a one-year mislabel was caught and fixed.
Colophon
Python pipeline (bake + gates + R2 sync) → Next.js server components. Zero client JavaScript except the nav and the player finder. Colors are semantic: green/red/violet are judgment (good/bad/small-sample), the violet→yellow heat ramp is volume only, and player identity in charts uses the brand pair. Baked recently; methods carry the formulas.