ref: add --out for local targets

[jorgeorpinel]

UPDATE: I see this is actually possible now (2.0). We should document it!
Q: Does the same apply to import-url?

---

Currently add -o only applies to "transferred" (external) data — straight-to-cache/remote functionality.

Since we're allowing add to move target data paths now, why not enable it for targets in the workspace too? E.g.:

$ ls
yowassup
$ dvc add ./yowassup -o nicername
...
$ ls
yowassup  nicername  nicername.dvc

Other than UI consistency, there could be actual use cases for this like tracking copies of a same dataset that you know will have variations in different stages/pipelines (may work well with foreach stages).

+ I assume enabling this at this point is as easy as removing the restriction that prevents it.

[jorgeorpinel]

Docs should also clarify that -o by itself implies "skip workspace" (straight-to-cache) for external targets. But creates the "copy" (link usually) for local ones.

[jorgeorpinel]

Hi @isidentical. Could you maybe point to the PR where this was introduced? Not critical but could be helpful. Thanks

[isidentical]

Since we're allowing add to move target data paths now, why not enable it for targets in the workspace too

It is already supported.

point to the PR where this was introduced

iterative/dvc/pull/5301

[jorgeorpinel]

already supported

Yep thanks @isidentical that's why I had already moved this to the docs repo 🙂

Thanks for the core PR link!