diff --git a/content/docs/command-reference/dag.md b/content/docs/command-reference/dag.md
index ff01c3f9f4..7b04f39479 100644
--- a/content/docs/command-reference/dag.md
+++ b/content/docs/command-reference/dag.md
@@ -1,8 +1,7 @@
# dag
-Show [stages](/doc/command-reference/run) in a pipeline that lead to the
-specified stage. By default it lists
-[DVC-files](/doc/user-guide/dvc-files-and-directories).
+Display connected [stages](/doc/command-reference/run) in the pipelines that
+contains them.
## Synopsis
@@ -10,8 +9,8 @@ specified stage. By default it lists
usage: dvc dag [-h] [-q | -v] [--dot] [--full] [target]
positional arguments:
- targets Stage or output to show pipeline for (optional)
- Finds all stages in the workspace by default.
+ target Stage or output to show pipeline for (optional)
+ Uses all stages in the workspace by default.
```
## Description
@@ -19,31 +18,32 @@ positional arguments:
A data pipeline, in general, is a series of data processing
[stages](/doc/command-reference/run) (for example console commands that take an
input and produce an output). A pipeline may produce intermediate
-data, and has a final result. Machine learning (ML) pipelines typically start a
-with large raw datasets, include intermediate featurization and training stages,
-and produce a final model, as well as accuracy
-[metrics](/doc/command-reference/metrics).
+data, and has a final result.
+
+Machine learning (ML) pipelines typically start a with large raw datasets,
+include intermediate featurization and training stages, and produce a final
+model, as well as accuracy [metrics](/doc/command-reference/metrics).
In DVC, pipeline stages and commands, their data I/O, interdependencies, and
-results (intermediate or final) are specified with `dvc add` and `dvc run`,
-among other commands. This allows DVC to restore one or more pipelines of stages
-interconnected by their dependencies and outputs later. (See `dvc repro`.)
+results (intermediate or final) are specified in `dvc.yaml`, which can be
+written manually or built using the helper command `dvc run`. This allows DVC to
+restore one or more pipelines later (see `dvc repro`).
> DVC builds a dependency graph
> ([DAG](https://en.wikipedia.org/wiki/Directed_acyclic_graph)) to do this.
-`dvc dag` displays the stages of a pipeline up to the target stage. If `target`
-is omitted, it will show the full project DAG.
+`dvc dag` command displays the stages of a pipeline up to the target stage. If
+`target` is omitted, it will show the full project DAG.
## Options
+- `--full` - show full DAG that the `target` stage belongs too, instead of
+ showing only its ancestors.
+
- `--dot` - show DAG in
[DOT]()
format. It can be passed to third party visualization utilities.
-- `--full` - show full DAG that the `target` belongs too, instead of showing the
- part that consists only of the target ancestors.
-
- `-h`, `--help` - prints the usage/help message, and exit.
- `-q`, `--quiet` - do not write anything to standard output. Exit with 0 if no
diff --git a/content/docs/command-reference/push.md b/content/docs/command-reference/push.md
index 4159ef49be..18e0d33fae 100644
--- a/content/docs/command-reference/push.md
+++ b/content/docs/command-reference/push.md
@@ -158,7 +158,6 @@ a [pipeline](/doc/command-reference/pipeline) has been setup with these
```dvc
$ dvc pipeline show
-
data/Posts.xml.zip.dvc
Posts.xml.dvc
Posts.tsv.dvc
diff --git a/content/docs/user-guide/running-dvc-on-windows.md b/content/docs/user-guide/running-dvc-on-windows.md
index 1d4e216a08..8699b74d49 100644
--- a/content/docs/user-guide/running-dvc-on-windows.md
+++ b/content/docs/user-guide/running-dvc-on-windows.md
@@ -70,8 +70,8 @@ directory, as explained in
## Enabling paging with `less`
By default, DVC tries to use [Less]()
-as pager for the output of `dvc dag`. Windows doesn't have the less command
-available however. Fortunately, there is a easy way of installing `less` via
+as pager for the output of `dvc dag`. Windows doesn't have the `less` command
+available however. Fortunately, there is a easy way of installing it via
[Chocolatey](https://chocolatey.org/) (please install the tool first):
```dvc
diff --git a/redirects-list.json b/redirects-list.json
index 9285fed991..13776b035c 100644
--- a/redirects-list.json
+++ b/redirects-list.json
@@ -31,11 +31,11 @@
"^/doc/understanding-dvc(/.*)?$ /doc/user-guide/what-is-dvc",
"^/doc/commands-reference(/.*)?$ /doc/command-reference$1",
"^/doc/command-reference/plot$ /doc/command-reference/plots",
- "^/doc/command-reference/lock$ /doc/command-reference/freeze",
- "^/doc/command-reference/unlock$ /doc/command-reference/unfreeze",
"^/doc/command-reference/pipeline$ /doc/command-reference/dag",
"^/doc/command-reference/pipeline/show$ /doc/command-reference/dag",
"^/doc/command-reference/pipeline/list$ /doc/command-reference/dag",
+ "^/doc/command-reference/lock$ /doc/command-reference/freeze",
+ "^/doc/command-reference/unlock$ /doc/command-reference/unfreeze",
"^/(.+)/$ /$1"
]