Extracted from and related to #4292
The targets param accepted by dvc repro is described (in its help output) as Stages to reproduce. 'dvc.yaml' by default. This message is confusing as dvc.yaml is not a stage. In docs we're using Stage or .dvc file to reproduce but that's not correct either because apparently paths to dvc.yaml files are also accepted.
- -R, --recursive Reproduce all stages in the specified directory.
+ -R, --recursive Reproduce all stages in the specified directories.
+ These can be given as `targets` arguments.
and I'll explain this special case further in the cmd ref. Options.
OPTIONALLY, should repro NOT accept dvc.yaml files as targets, and change the default description to "all stages in dvc.yaml"?
p.s. which other commands accept dvc.yaml file paths as targets?
The
targetsparam accepted bydvc reprois described (in its help output) asStages to reproduce. 'dvc.yaml' by default.This message is confusing as dvc.yaml is not a stage. In docs we're usingStage or .dvc file to reproducebut that's not correct either because apparently paths to dvc.yaml files are also accepted.Stage or path to dvc.yaml or .dvc file to reproduceinstead?and I'll explain this special case further in the cmd ref. Options.
OPTIONALLY, should repro NOT accept dvc.yaml files as targets, and change the default description to "all stages in dvc.yaml"?
p.s. which other commands accept dvc.yaml file paths as targets?