diff --git a/content/docs/command-reference/metrics/diff.md b/content/docs/command-reference/metrics/diff.md index daec243ab7..9f22f21f61 100644 --- a/content/docs/command-reference/metrics/diff.md +++ b/content/docs/command-reference/metrics/diff.md @@ -56,6 +56,9 @@ lists all the current metrics without comparisons. $ dvc metrics diff HEAD v1 --targets t1.json t2.json ``` + Note, that when using `--targets` it is possible to `diff` files that are not + specifically marked as metrics. + - `-R`, `--recursive` - determines the metric files to use by searching each target directory and its subdirectories for DVC-files to inspect. If there are no directories among the `targets`, this option is ignored. diff --git a/content/docs/command-reference/metrics/show.md b/content/docs/command-reference/metrics/show.md index 35d4220281..eb8e9f61b6 100644 --- a/content/docs/command-reference/metrics/show.md +++ b/content/docs/command-reference/metrics/show.md @@ -22,11 +22,11 @@ Finds and prints all metrics in the project by examining all of its > This kind of metrics can be defined with the `-m` (`--metrics`) and `-M` > (`--metrics-no-cache`) options of `dvc run`. -If `targets` are provided, it will show those specific metric files instead. -With the `-a` or `-T` options, this command shows the different metrics values -across all Git branches or tags, respectively. With the `-R` option, some of the -target can even be directories, so that DVC recursively shows all metric files -inside. +If `targets` are provided, it will show those specific files instead, even if +they are not found as `metrics` in `dvc.yaml`. With the `-a` or `-T` options, +this command shows the different metrics values across all Git branches or tags, +respectively. With the `-R` option, some of the target can even be directories, +so that DVC recursively shows all metric files inside. An alternative way to display metrics is the `dvc metrics diff` command, which compares them with a previous version.