Skip to content

6 articles

↑ ↓ to navigate · Enter to readEsc to close
Back to journalWeavers / Journal
Engineering / WEAVERS JOURNAL

Your result is only as useful as its context.

A research record should make it possible to understand what ran, with which inputs, and why.

WWeavers Journal1 min readSample article

Capture the inputs

Keep the data source, time window, configuration, and code revision together. These details explain what the experiment actually evaluated.

Distinguish a rerun from a new experiment

If you change an assumption, give the new run its own record. Comparing explicit versions is easier than reconstructing the history of an overwritten result.

Record what you learned

Save observations and open questions with the output. A reproducible result should help the next person continue the reasoning, not merely repeat the computation.

Reproducibility is also a way of communicating clearly.