Skip to content

Commit

Permalink
run: add comment about determinism
Browse files Browse the repository at this point in the history
  • Loading branch information
Mr. Outis committed Dec 6, 2019
1 parent e29e498 commit 23d431a
Showing 1 changed file with 7 additions and 2 deletions.
9 changes: 7 additions & 2 deletions static/docs/command-reference/run.md
Original file line number Diff line number Diff line change
Expand Up @@ -62,10 +62,15 @@ some principles:

- Read exclusively from specified dependencies.
- Write exclusively to specified outputs.
- Completely rewrite the outputs (do not append).
- Completely rewrite the outputs (i.e. do not append or edit).
- Stop reading and writing when the command exits.

This will enhance reproducibility.
To guarantee reproducibilty, your command should be
[deterministic](https://en.wikipedia.org/wiki/Deterministic_algorithm) (i.e. it
must produce the same results given the same inputs/dependencies).

Have in mind what brings entropy to your command (e.g. random generators, seeds,
hardware, etc.).

## Options

Expand Down

0 comments on commit 23d431a

Please sign in to comment.