diff --git a/static/docs/command-reference/import.md b/static/docs/command-reference/import.md index 1444626f0f..c7260ccc40 100644 --- a/static/docs/command-reference/import.md +++ b/static/docs/command-reference/import.md @@ -1,9 +1,10 @@ # import -Download or copy file or directory from any DVC project in a Git -repository (e.g. hosted on GitHub) into the workspace, and track -changes in this [external dependency](/doc/user-guide/external-dependencies). -Creates [DVC-files](/doc/user-guide/dvc-file-format). +Download or copy an output file or directory from any DVC +repository (e.g. hosted on GitHub) into the workspace. DVC +creates a [DVC-file](/doc/user-guide/dvc-file-format) with information about the +data source, which can later be used to [update](/doc/command-reference/update) +the import. > See also `dvc get`, that corresponds to the first step this command performs > (just download the data). @@ -47,12 +48,11 @@ _import stage_ (DVC-file) is then created, extending the full file or directory name of the imported data e.g. `data.txt.dvc` – similar to having used `dvc run` to generate the same output. -DVC supports DVC-files that refer to data in an external DVC repository (hosted -on a Git server) a.k.a _import stages_. In such a DVC-file, the `deps` section -specifies the `repo` URL and data `path`, and the `outs` section contains the -corresponding local path in the workspace. It records enough data from the -imported data to enable DVC to efficiently check it to determine whether the -local copy is out of date. +DVC-files support references to data in an external DVC repository (hosted on a +Git server). In such a DVC-file, the `deps` section specifies the `repo`-`url` +and data `path` fields, and the `outs` section contains the corresponding local +workspace `path` field. This is enough data about the imported data, to enable +DVC efficiently determining whether the local copy is out of date. To actually [track the data](https://dvc.org/doc/get-started/add-files), `git add` (and `git commit`) the import stage. @@ -100,9 +100,9 @@ Importing 'data/data.xml (git@github.com:iterative/example-get-started)' In contrast with `dvc get`, this command doesn't just download the data file, but it also creates an import stage -([DVC-file](/doc/user-guide/dvc-file-format)) to register this data as an -[external dependency](/doc/user-guide/external-dependencies) (using the `repo` -field). Check `data.xml.dvc`: +([DVC-file](/doc/user-guide/dvc-file-format)) with a link to the data source (as +explained in the description above). (This import stage can later be used to +[update](/doc/command-reference/update) the import.) Check `data.xml.dvc`: ```yaml md5: 7de90e7de7b432ad972095bc1f2ec0f8 diff --git a/static/docs/get-started/initialize.md b/static/docs/get-started/initialize.md index 1fbc6d85fe..61b5360b1f 100644 --- a/static/docs/get-started/initialize.md +++ b/static/docs/get-started/initialize.md @@ -1,8 +1,8 @@ # Initialize There are a few recommended ways to install DVC: OS-specific package/installer, -`pip`, `conda`, and Homebrew. See the [**Installation**](/doc/install) page for -all the options and details. +`pip`, `conda`, and Homebrew. See [Installation](/doc/install) for all the +options and details. Let's start by creating a workspace we can version with Git. Then run `dvc init` inside to create the DVC project: