Leave a trail

Claim: a job leaves what was asked, what was found, what was produced and where it lives, so that a second person can resume it.

What it asks

  • Keep one folder per project, with an overview file at its root that lists the parts.
  • Fill a table with four rows: what was asked, what was found, what was produced, where each lives.
  • Date the log, so the order of the work can be read back.

Why

  • Two guides for computational work prescribe the same things: an overview file, a folder per project and a dated log (Noble 2009; Wilson 2017).
  • A third makes its first rule to keep track, for every result, of how it was produced (Sandve 2013).

Limits

  • The guides are practice; none measures resumption.
  • The four rows are the maintainer's current answer to the review's question on the trail, not a tested minimum.