Skip to content

Commit

Permalink
cmd ref: use positive wording in ref to update in re-importing example
Browse files Browse the repository at this point in the history
  • Loading branch information
jorgeorpinel committed Nov 18, 2019
1 parent 2cb3aaa commit 89e45ac
Showing 1 changed file with 9 additions and 10 deletions.
19 changes: 9 additions & 10 deletions static/docs/command-reference/import.md
Original file line number Diff line number Diff line change
Expand Up @@ -150,16 +150,15 @@ deps:

If the
[Git revision](https://git-scm.com/book/en/v2/Git-Internals-Git-References)
tends to move, i.e. branches, this doesn't have much of an effect on the
import/update workflow. However, for typically static references i.e. tags, or
for SHA commits, `dvc update` will not have any effect on the import.

In this cases, in order to actually "update" an import, it's necessary to
**re-import the data** instead, by using `dvc import` again without or with a
different `--rev`. This will overwrite the import stage (DVC-file), either
removing or replacing the `rev` field, respectively. This can produce an import
stage that is able to be updated normally with `dvc update` going forward. For
example:
moves (e.g. branches), you may use `dvc update` to bring the data up to date.
This will update `rev_lock` in the import stage (DVC-file).

However, for typically static references (e.g. tags), or for SHA commits, in
order to actually "update" an import, it's necessary to **re-import the data**
instead, by using `dvc import` again without or with a different `--rev`. This
will overwrite the import stage (DVC-file), either removing or replacing the
`rev` field, respectively. This can produce an import stage that is able to be
updated normally with `dvc update` going forward. For example:

```dvc
$ dvc import --rev master \
Expand Down

0 comments on commit 89e45ac

Please sign in to comment.