From f62f543480c771de723663345a55a1b1b0834bcc Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Mon, 6 Jul 2020 15:07:14 -0500
Subject: [PATCH] cmd: rephrase intro of run per
 https://github.com/iterative/dvc.org/pull/1526#discussion_r449985121

---
 content/docs/command-reference/run.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/content/docs/command-reference/run.md b/content/docs/command-reference/run.md
index f81780bd81..3ff4870990 100644
--- a/content/docs/command-reference/run.md
+++ b/content/docs/command-reference/run.md
@@ -1,13 +1,13 @@
 # run
 
-Create a pipeline _stage_ in
-[`dvc.yaml`](/doc/user-guide/dvc-files-and-directories) from a given command,
-and execute the command.
+Helper command to create or update _stages_ in
+[`dvc.yaml`](/doc/user-guide/dvc-files-and-directories). Requires a name and a
+command.
 
 ## Synopsis
 
 ```usage
-usage: dvc run [-h] [-q | -v] [-d <path>] [-n <name>] [-o <path>]
+usage: dvc run [-h] [-q | -v] -n <name> [-d <path>] [-o <path>]
                [-O <path>] [-p [<path>:]<params_list>] [-m <path>]
                [-M <path>] [--plots <path>] [--plots-no-cache <path>]
                [-w <path>] [--no-exec] [-f]
@@ -17,7 +17,7 @@ usage: dvc run [-h] [-q | -v] [-d <path>] [-n <name>] [-o <path>]
                command
 
 positional arguments:
-  command               Command to execute.
+  command               Command for the stage. Executed by default
 ```
 
 ## Description