ref: clarfy --out option

per #2302 (review)

Author: jorgeorpinel

content/docs/command-reference/add.md

@@ -146,10 +146,10 @@ not.
   Shell style wildcards supported: `*`, `?`, `[seq]`, `[!seq]`, and `**`
 
 - `-o <path>`, `--out <path>` - destination `path` inside the workspace to place
-  a data target (instead of using the current working directory). Directories
-  specified in the path will be created by this command. Note that this can be
-  used [with an external cache](#straight-to-cache) to avoid using the local
-  file system.
+  the data target. By default the data base file name is used in the current
+  working directory (if this option isn't used). Directories in the given `path`
+  will be created. Note that for external targets, this can be combined
+  [with an external cache](#straight-to-cache) to skip the local file system.
 
 - `--to-remote` - allow a target outside of the DVC repository (e.g. an S3
   object, SSH directory URL, file on mounted volume, etc.) but don't move it

content/docs/command-reference/get.md

@@ -57,8 +57,9 @@ name.
 ## Options
 
 - `-o <path>`, `--out <path>` - destination `path` to place the downloaded file
-  or directory (instead of using the current working directory). Directories
-  specified in the path will be created by this command.
+  or directory. By default the data base file name is used in the current
+  working directory (if this option isn't used). Directories in the given `path`
+  will be created.
 
 - `--rev <commit>` - commit hash, branch or tag name, etc. (any
   [Git revision](https://git-scm.com/docs/revisions)) of the repository to

content/docs/command-reference/import.md

@@ -80,9 +80,9 @@ repo at `url`) are not supported.
 ## Options
 
 - `-o <path>`, `--out <path>` - destination `path` inside the workspace to place
-  the downloaded file or directory (instead of using the current working
-  directory). Directories specified in the path must already exist, otherwise
-  this command will fail.
+  the downloaded file or directory. By default the data base file name is used
+  in the current working directory (if this option isn't used). Directories in
+  the given `path` will be created.
 
 - `--file <filename>` - specify a path and/or file name for the `.dvc` file
   created by this command (e.g. `--file stages/stage.dvc`). This overrides the