From 1185efcc32867cbd5a5326fd1b86f983c66cf1ee Mon Sep 17 00:00:00 2001 From: Jorge Orpinel Date: Tue, 21 Jan 2020 16:00:37 -0600 Subject: [PATCH] cmd ref: improve note about verify option and add it to `remote add`-> GDrive per https://github.com/iterative/dvc.org/pull/937#issuecomment-576890090 --- public/static/docs/command-reference/remote/add.md | 6 ++++++ public/static/docs/command-reference/remote/modify.md | 10 ++++++---- 2 files changed, 12 insertions(+), 4 deletions(-) diff --git a/public/static/docs/command-reference/remote/add.md b/public/static/docs/command-reference/remote/add.md index c6dbd6166d..0ed4b04e5a 100644 --- a/public/static/docs/command-reference/remote/add.md +++ b/public/static/docs/command-reference/remote/add.md @@ -240,6 +240,12 @@ drive is opened. For example, for the URL $ dvc remote add myremote gdrive://0AIac4JZqHhKmUk9PDA/my-dvc-root ``` +Note that GDrive remotes are not "trusted" by default. This means that the +[`verify`](`/doc/command-reference/remote/modify#available-settings-for-all-remotes`) +option is enabled on this type of storage, so DVC recalculates the checksums of +files upon download (e.g. `dvc pull`), to make sure that these haven't been +modified. +
diff --git a/public/static/docs/command-reference/remote/modify.md b/public/static/docs/command-reference/remote/modify.md index 6e43783993..d10d6b1506 100644 --- a/public/static/docs/command-reference/remote/modify.md +++ b/public/static/docs/command-reference/remote/modify.md @@ -63,10 +63,12 @@ manual editing could be used to change the configuration. The following options are available for all remote types: -- `verify` - upon downloading cache files (`dvc pull`, `dvc fetch`) DVC will - recalculate downloaded file checksums to make sure that these are not - corrupted or modified during download. It may slow down the aforementioned - commands. +- `verify` - upon downloading cache files (`dvc pull`, `dvc fetch`) + DVC will recalculate the checksums of files upon download (e.g. `dvc pull`) to + make sure that these haven't been modified, or corrupted during download. It + may slow down the aforementioned commands. + + > Note that this option is enabled on **Google Drive** remotes by default. ```dvc $ dvc remote modify myremote verify true