Skip to content

Commit

Permalink
cmd ref: update lock about import stages
Browse files Browse the repository at this point in the history
  • Loading branch information
jorgeorpinel committed Apr 22, 2020
1 parent 0f0c721 commit 0390a95
Showing 1 changed file with 12 additions and 12 deletions.
24 changes: 12 additions & 12 deletions content/docs/command-reference/lock.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,10 +3,6 @@
Lock a [DVC-file](/doc/user-guide/dvc-file-format)
([stage](/doc/command-reference/run)). Use `dvc unlock` to unlock the file.

If a DVC-file is locked, the stage is considered unchanged. `dvc repro` will not
execute commands to regenerate outputs of locked stages, even if some
dependencies have changed and even if `--force` is provided.

## Synopsis

```usage
Expand All @@ -19,14 +15,18 @@ positional arguments:
## Description

`dvc lock` causes any DVC-file to be considered _not changed_ by `dvc status`
and `dvc repro`.

Locking a stage is useful to avoid syncing data from the top of its pipeline,
and keep iterating on the last (unlocked) stages only.

Note that <abbr>import stages</abbr> are considered always locked. They can not
be unlocked. Use `dvc update` on them to update the file, directory, or
<abbr>data artifact</abbr> from its external data source.
and `dvc repro`. `dvc repro` will not execute commands to regenerate
<abbr>outputs</abbr> of locked stages, even if some dependencies have changed,
and even if `--force` is provided.

Locking a stage is useful to avoid syncing data from the top of its
[pipeline](/doc/command-reference/pipeline), and keep iterating on the last
(unlocked) stages only.

Note that <abbr>import stages</abbr> are considered always locked. Use
`dvc update` to update the corresponding <abbr>data artifacts</abbr> from the
external data source. [Unlock](/doc/command-reference/unlock) them before using
`dvc repro` on a pipeline that needs their outputs.

## Options

Expand Down

0 comments on commit 0390a95

Please sign in to comment.