exp run --reset : Clarify behavior

[daavoo]

If the user has a pipeline using checkpoints and runs dvc exp run --reset without changing the deps, the checkpoints: true stage(s) run(s) again.

This is currently intended behavior, it's not really a bug. Doing exp run --reset is treated similarly to doing dvc repro --force, and will reproduce your entire pipeline from the initial checkpoint state.

I see. I guess that at least we should clarify this --force similarity in the docs, as it seems to be missing from https://dvc.org/doc/command-reference/exp/run#--reset

From iterative/dvc#6475

UPDATE: Also

reset here is to reset the epochs to 0, so it is reasonable to restart the training

[dberenbaum]

Agree that we should clarify, but let's decide on what the expected behavior is before changing the functionality or docs. I don't think the current docs are clear about whether the experiment will be run again.

Related: iterative/dvc#6475

[jorgeorpinel]

If it's a small edit like just saying "this has the same result as --reset above" in the --force bullet then let's go for it meanwhile?

[dberenbaum]

Sure, if we can easily add more clarity, there's no harm.

[jorgeorpinel]

Actually, this seems to be addressed by https://github.com/iterative/dvc.org/pull/3182/files#diff-162526d7eb1876fbb25840504db2c51860ae3c1b7af5b5f6431b0828c827189f 🙂 (I think)