Skip to content

Commit 5ce488c

Browse files
yathomasirenovate[bot]
authored andcommitted
run fix
1 parent f681317 commit 5ce488c

File tree

32 files changed

+116
-129
lines changed

32 files changed

+116
-129
lines changed

packages/example/content/docs/command-reference/add.md

Lines changed: 6 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -350,11 +350,10 @@ When you want to add a large dataset that is outside of your
350350
it into the <abbr>workspace</abbr> first. But you may not have enough local
351351
storage space.
352352

353-
You can however set up an [external cache] that can handle the data. To avoid
354-
ever making a local copy, target the outside data with `dvc add` while
355-
specifying an `--out` (`-o`) path inside of your project. This way the data will
356-
be transferred to the <abbr>cache</abbr> directly, and then [linked] into your
357-
workspace.
353+
You can however set up an [external cache] that can handle the data. To avoid ever
354+
making a local copy, target the outside data with `dvc add` while specifying an `--out`
355+
(`-o`) path inside of your project. This way the data will be transferred to the
356+
<abbr>cache</abbr> directly, and then [linked] into your workspace.
358357

359358
Let's add a `data.xml` file via HTTP, putting it in `./data.xml`:
360359

@@ -389,8 +388,8 @@ dataset, but you still want to track it in the <abbr>project</abbr> so it can be
389388
[pulled](/doc/command-reference/plots) later.
390389

391390
As long as you have setup [remote storage] that can handle the data, this can be
392-
achieved with the `--to-remote` flag. It creates a `.dvc` file without
393-
downloading anything, transferring a target directly to a DVC remote instead:
391+
achieved with the `--to-remote` flag. It creates a `.dvc` file without downloading
392+
anything, transferring a target directly to a DVC remote instead:
394393

395394
Let's add a `data.xml` file via HTTP straight to remote:
396395

packages/example/content/docs/command-reference/commit.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -50,8 +50,8 @@ Some scenarios for `dvc commit` include:
5050
versions without having to execute stage commands.
5151

5252
- Sometimes after executing a <abbr>stage</abbr>, we realize that not all of its
53-
dependencies or outputs are defined in `dvc.yaml`. It is possible to [add the
54-
missing deps/outs] without having to re-execute stages, and `dvc commit` is
53+
dependencies or outputs are defined in `dvc.yaml`. It is possible to [add
54+
the missing deps/outs] without having to re-execute stages, and `dvc commit` is
5555
needed to finalize the operation (see link).
5656

5757
- It's also possible to execute stage commands by hand (without `dvc repro`), or

packages/example/content/docs/command-reference/exp/branch.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,8 @@ positional arguments:
1717

1818
Makes a given Git [`branch`] containing the target `experiment`. This makes the
1919
experiment into a [regular commit], or several in the case of [checkpoint
20-
experiments] (one per checkpoint).
20+
experiments]
21+
(one per checkpoint).
2122

2223
The new `branch` will be based on the experiment's parent commit (`HEAD` at the
2324
time that the experiment was run). Note that DVC **does not** switch into the

packages/example/content/docs/command-reference/exp/init.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -37,8 +37,8 @@ Repository structure assumed by default:
3737
```
3838

3939
> Note that `dvc exp init` expects at least a `params.yaml` file present. DVC
40-
> reads it to find parameters to include in the [stage definition]. It can
41-
> however be omitted when using the `--explicit` and/or `-i` flags.
40+
> reads it to find parameters to include in the [stage definition]. It can however
41+
> be omitted when using the `--explicit` and/or `-i` flags.
4242
4343
You must always provide a command that runs your experiment(s). It can be given
4444
either directly [as an argument](#the-command-argument), or by using the
@@ -48,8 +48,8 @@ wrapped as a <abbr>stage</abbr> that `dvc exp run` can execute.
4848
Different types of stages are supported, such as `dl` (deep learning) which uses
4949
[DVCLive](/doc/dvclive) to monitor [checkpoints] during training of ML models.
5050

51-
> `dvc exp init` is intended as a quick way to start running [DVC Experiments].
52-
> See the `dvc.yaml` specification for complex data pipelines.
51+
> `dvc exp init` is intended as a quick way to start running [DVC Experiments]. See
52+
> the `dvc.yaml` specification for complex data pipelines.
5353
5454
[stage definition]:
5555
/doc/user-guide/project-structure/pipelines-files#stage-entries

packages/example/content/docs/command-reference/exp/run.md

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -33,25 +33,23 @@ directories, etc.
3333
Use the `--set-param` (`-S`) option as a shortcut to change
3434
<abbr>parameter</abbr> values [on-the-fly] before running the experiment.
3535

36-
It's possible to [queue experiments] for later execution with the `--queue`
37-
flag. To actually run them, use `dvc exp run --run-all`. Queued experiments are
38-
run sequentially by default, but can be run in parallel using the `--jobs`
39-
option.
36+
It's possible to [queue experiments] for later execution with the `--queue` flag.
37+
To actually run them, use `dvc exp run --run-all`. Queued experiments are run sequentially
38+
by default, but can be run in parallel using the `--jobs` option.
4039

4140
> ⚠️ Parallel runs are experimental and may be unstable. Make sure you're using
4241
> a number of jobs that your environment can handle (no more than the CPU
4342
> cores).
4443
45-
It's also possible to run special [checkpoint experiments] that log the
46-
execution progress (useful for deep learning ML). The `--rev` and `--reset`
47-
options have special uses for these.
44+
It's also possible to run special [checkpoint experiments] that log the execution
45+
progress (useful for deep learning ML). The `--rev` and `--reset` options have special
46+
uses for these.
4847

4948
> 📖 See the [Running Experiments] guide for more details on all these features.
5049
5150
[Review] your experiments with `dvc exp show`. Successful ones can be [made
52-
persistent] by restoring them via `dvc exp branch` or `dvc exp apply` and
53-
committing them to the Git repo. Unnecessary ones can be [cleared] with
54-
`dvc exp gc`.
51+
persistent] by restoring them via `dvc exp branch` or `dvc exp apply` and committing
52+
them to the Git repo. Unnecessary ones can be [cleared] with `dvc exp gc`.
5553

5654
[on-the-fly]: #example-modify-parameters-on-the-fly
5755
[queue experiments]:

packages/example/content/docs/command-reference/gc.md

Lines changed: 11 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -25,10 +25,10 @@ details.
2525
The data kept is determined by reading the <abbr>DVC files</abbr> in the set of
2626
commits of the given scope.
2727

28-
> Note that `dvc gc` tries to fetch missing [`.dir` files] from remote storage
29-
> to local cache in order to determine which files should exist inside cached
30-
> directories. These files may be missing if the cache was previously garbage
31-
> collected, in a newly cloned copy of the repo, etc.
28+
> Note that `dvc gc` tries to fetch missing [`.dir` files] from remote storage to
29+
> local cache in order to determine which files should exist inside cached directories.
30+
> These files may be missing if the cache was previously garbage collected, in a
31+
> newly cloned copy of the repo, etc.
3232
3333
Unless the `--cloud` option is used, any files collected from the cache can be
3434
restored using `dvc fetch`, as long as they have been previously uploaded with
@@ -96,15 +96,14 @@ project we want to clear.
9696

9797
> \* Not including [DVC experiments]
9898
99-
- `--all-experiments` keep cached objects referenced in all [DVC experiments],
100-
as well as in the workspace (implying `-w`). This preserves the project's
101-
[experimental](/doc/user-guide/experiment-management) data (including
102-
checkpoints). See also `dvc exp gc`.
99+
- `--all-experiments` keep cached objects referenced in all [DVC experiments], as
100+
well as in the workspace (implying `-w`). This preserves the project's [experimental](/doc/user-guide/experiment-management)
101+
data (including checkpoints). See also `dvc exp gc`.
103102

104-
- `-p <paths>`, `--projects <paths>` - if a single remote or a single [cache is
105-
shared] among different projects, this option can be used to specify a list of
106-
them (each project is a path) to keep data that is currently referenced from
107-
them.
103+
- `-p <paths>`, `--projects <paths>` - if a single remote or a single [cache
104+
is shared] among different projects, this option can be used to specify a list
105+
of them (each project is a path) to keep data that is currently referenced
106+
from them.
108107

109108
- `-c`, `--cloud` - remove files in remote storage in addition to local cache.
110109
**This option is dangerous.** The default remote is used unless a specific one

packages/example/content/docs/command-reference/import-url.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -368,8 +368,8 @@ dataset, but you still want to track it in the <abbr>project</abbr> so it can be
368368
[pulled](/doc/command-reference/plots) later.
369369

370370
As long as you have setup [remote storage] that can handle the data, this can be
371-
achieved with the `--to-remote` flag. It creates an import `.dvc` file without
372-
downloading anything, transferring a target directly to a DVC remote instead.
371+
achieved with the `--to-remote` flag. It creates an import `.dvc` file without downloading
372+
anything, transferring a target directly to a DVC remote instead.
373373

374374
Let's import a `data.xml` file via HTTP straight to remote:
375375

packages/example/content/docs/command-reference/pull.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,9 @@ positional arguments:
2020

2121
The `dvc push` and `dvc pull` commands are the means for uploading and
2222
downloading data to and from remote storage (S3, SSH, GCS, etc.). These commands
23-
are similar to `git push` and `git pull`, respectively. [Data sharing] across
24-
environments and preserving data versions (input datasets, intermediate results,
25-
models, [metrics](/doc/command-reference/metrics), etc.) remotely are the most
26-
common use cases for these commands.
23+
are similar to `git push` and `git pull`, respectively. [Data sharing] across environments
24+
and preserving data versions (input datasets, intermediate results, models, [metrics](/doc/command-reference/metrics),
25+
etc.) remotely are the most common use cases for these commands.
2726

2827
`dvc pull` downloads tracked data from
2928
[remote storage](/doc/command-reference/remote) to the <abbr>cache</abbr>, and

packages/example/content/docs/command-reference/push.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,9 @@ positional arguments:
2020

2121
The `dvc push` and `dvc pull` commands are the means for uploading and
2222
downloading data to and from remote storage (S3, SSH, GCS, etc.). These commands
23-
are similar to `git push` and `git pull`, respectively. [Data sharing] across
24-
environments, and preserving data versions (input datasets, intermediate
25-
results, models, [metrics](/doc/command-reference/metrics), etc.) remotely are
26-
the most common use cases for these commands.
23+
are similar to `git push` and `git pull`, respectively. [Data sharing] across environments,
24+
and preserving data versions (input datasets, intermediate results, models, [metrics](/doc/command-reference/metrics),
25+
etc.) remotely are the most common use cases for these commands.
2726

2827
`dvc push` uploads data from the <abbr>cache</abbr> to
2928
[remote storage](/doc/command-reference/remote).

packages/example/content/docs/command-reference/remote/modify.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -890,8 +890,8 @@ by HDFS. Read more about by expanding the WebHDFS section in
890890
$ dvc remote modify myremote kerberos true
891891
```
892892

893-
- `kerberos_principal` - [Kerberos principal] to use, in case you have multiple
894-
ones (for example service accounts). Only used if `kerberos` is `true`.
893+
- `kerberos_principal` - [Kerberos principal] to use, in case you have multiple ones
894+
(for example service accounts). Only used if `kerberos` is `true`.
895895

896896
```dvc
897897
$ dvc remote modify myremote kerberos_principal myprincipal

0 commit comments

Comments
 (0)