Historical design guidance · no release version established
Six historical design rules
This page records earlier design guidance. No release version was established for these statements, so they are not a compatibility contract for your bundle. Use the named snapshot on each measure reference for its calculation, inputs and missing-value conditions; consult your matching bundle documentation for storage and release-check guarantees.
The rules below record that design’s publication checks and value representations.
1. One fact has one owner
Every published column is declared once, with its meaning and the analysis that produces it. Two analyses cannot write the same fact.
2. Publication fails closed
If a producer and the declared contract disagree, or a key repeats, or a parent is missing, nothing is published. The old file is replaced only after the new one is written and has passed an integrity check.
3. One representation for each value
Instants are UTC text with six fractional digits. Days are YYYY-MM-DD in the run’s time zone. Durations are seconds. Blank text is empty, and a cell holds one value.
4. The method stays visible
Method-dependent measures identify their method in the name or definition. A Theil index retains its statistical name and definition.
5. The documentation is generated
The schema document and the Reader’s contract snapshot come from the same declaration as the file. A check fails the release when they differ.
6. Unknown is never zero
Every file has every table and column. Where an analysis did not run, the measure is empty and a warning says so. See the warnings for what each empty measure reports.