Merge pull request #1432 from iterative/2020-06-10

Regular updates (June 16)

content/docs/command-reference/checkout.md

@@ -10,8 +10,9 @@ usage: dvc checkout [-h] [-q | -v] [--summary] [-d] [-R] [-f]
                     [--relink] [targets [targets ...]]
 
 positional arguments:
-  targets          DVC-files to checkout. Optional. (Finds all
-                   DVC-files in the workspace by default.)
+  targets        Limit command scope to these stages or .dvc files.
+                 Using -R, directories to search for stages or .dvc
+                 files can also be given.
 ```
 
 ## Description

content/docs/command-reference/commit.md

@@ -11,8 +11,9 @@ usage: dvc commit [-h] [-q | -v] [-f] [-d] [-R]
                   [targets [targets ...]]
 
 positional arguments:
-  targets          DVC-files to commit. Optional. (Finds all DVC-files
-                   in the workspace by default.)
+  targets        Limit command scope to these stages or .dvc files.
+                 Using -R, directories to search for stages or .dvc
+                 files can also be given.
 ```
 
 ## Description

content/docs/command-reference/fetch.md

@@ -12,8 +12,8 @@ usage: dvc fetch [-h] [-q | -v] [-j <number>]
 
 positional arguments:
   targets        Limit command scope to these stages or .dvc files.
-                 Using -R, directories can also be given, to search
-                 .dvc files in.
+                 Using -R, directories to search for stages or .dvc
+                 files can also be given.
 ```
 
 ## Description

content/docs/command-reference/import-url.md

@@ -84,7 +84,7 @@ Specific explanations:
   running. DVC automatically expands this URL into a regular S3, SSH, GS, etc
   URL by appending `/path/to/file` to the `myremote`'s configured base path.
 
-Another way to understand the `dvc import-url` command is as a short-cut for a
+Another way to understand the `dvc import-url` command is as a shortcut for a
 more verbose `dvc run` command. This is discussed in the
 [External Dependencies](/doc/user-guide/external-dependencies) documentation,
 where an alternative is demonstrated for each of these schemes.

content/docs/command-reference/pull.md

@@ -15,8 +15,8 @@ usage: dvc pull [-h] [-q | -v] [-j <number>]
 
 positional arguments:
   targets        Limit command scope to these stages or .dvc files.
-                 Using -R, directories can also be given, to search
-                 .dvc files in.
+                 Using -R, directories to search for stages or .dvc files
+                 can also be given.
 ```
 
 ## Description

content/docs/command-reference/push.md

@@ -12,8 +12,8 @@ usage: dvc push [-h] [-q | -v] [-j <number>]
 
 positional arguments:
   targets        Limit command scope to these stages or .dvc files.
-                 Using -R, directories can also be given, to search
-                 .dvc files in.
+                 Using -R, directories to search for stages or .dvc files
+                 can also be given.
 ```
 
 ## Description

content/docs/command-reference/repro.md

@@ -13,7 +13,7 @@ usage: dvc repro [-h] [-q | -v] [-f] [-s] [-c <path>] [-m] [--dry] [-i]
                  [--no-commit] [--downstream] [targets [targets ...]]
 
 positional arguments:
-  targets               DVC-file to reproduce. 'Dvcfile' by default.
+  targets        Stage or .dvc file to reproduce. 'Dvcfile' by default.
 ```
 
 ## Description

content/docs/command-reference/status.md

@@ -14,8 +14,8 @@ usage: dvc status [-h] [-v] [-j <number>] [-q] [-c] [-r <name>] [-a] [-T]
 
 positional arguments:
   targets        Limit command scope to these stages or .dvc files.
-                 Using -R, directories can also be given, to search
-                 .dvc files in.
+                 Using -R, directories to search for stages or .dvc
+                 files can also be given.
 ```
 
 ## Description

content/docs/command-reference/update.md

@@ -11,7 +11,8 @@ usage: dvc update [-h] [-q | -v] [--rev <commit>] [-R]
                   targets [targets ...]
 
 positional arguments:
-  targets        .dvc files to update.
+  targets      import stage .dvc files to update. Using -R, directories
+               to search for .dvc files can also be given.
 ```
 
 ## Description
@@ -47,8 +48,8 @@ dvc update --rev master
   > revision.
 
 - `-R`, `--recursive` - determines the files to update 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.
+  directory and its subdirectories for import stage `.dvc` files to inspect. If
+  there are no directories among the targets, this option is ignored.
 
 - `-h`, `--help` - prints the usage/help message, and exit.
 

content/docs/user-guide/basic-concepts/external-dependency.md

@@ -3,7 +3,8 @@ name: 'External Dependency'
 match: ['external dependency', 'external dependencies']
 ---
 
-A [`dvc.yaml`](/doc/user-guide/dvc-file-format) file dependency with origin in
-an external source, for example HTTP, SSH, Amazon S3, Google Cloud Storage
+A stage dependency (`dep` field in [`dvc.yaml`](/doc/user-guide/dvc-file-format)
+or in an [import stage](/doc/command-reference/import) `.dvc` file) with origin
+in an external source, for example HTTP, SSH, Amazon S3, Google Cloud Storage
 remote locations, or even other DVC repositories. See
 [External Dependencies](/doc/user-guide/external-dependencies).