From 821359c2068ad4b09122683abe49c1a383f29dd2 Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Wed, 18 Mar 2020 23:29:34 -0600
Subject: [PATCH 01/15] api ref: update metrics add and remove descs per
 https://github.com/iterative/dvc/pull/3471#pullrequestreview-377170844

---
 content/docs/command-reference/metrics/add.md    | 3 +--
 content/docs/command-reference/metrics/remove.md | 6 +++---
 2 files changed, 4 insertions(+), 5 deletions(-)

diff --git a/content/docs/command-reference/metrics/add.md b/content/docs/command-reference/metrics/add.md
index 1d746bbd86..cd2a3d790c 100644
--- a/content/docs/command-reference/metrics/add.md
+++ b/content/docs/command-reference/metrics/add.md
@@ -1,7 +1,6 @@
 # metrics add
 
-Mark <abbr>output</abbr> file as a
-[project metric](/doc/command-reference/metrics).
+Mark a DVC-tracked file as a [project metric](/doc/command-reference/metrics).
 
 ## Synopsis
 
diff --git a/content/docs/command-reference/metrics/remove.md b/content/docs/command-reference/metrics/remove.md
index bbb6f77e95..c40a87182f 100644
--- a/content/docs/command-reference/metrics/remove.md
+++ b/content/docs/command-reference/metrics/remove.md
@@ -1,8 +1,8 @@
 # metrics remove
 
-Stop tracking a [project metric](/doc/command-reference/metrics): Keeps file
-located at `path` as an <abbr>output</abbr>, but removes its metric mark in the
-DVC-file.
+Remove metric mark on a DVC-tracked file: Keeps file located at `path` as an
+<abbr>output</abbr>, but removes its mark as a
+[project metric](/doc/command-reference/metrics) in the DVC-file.
 
 ## Synopsis
 

From 415901f69423160c85ac55eb1456ddb0f9630dcd Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Thu, 19 Mar 2020 00:01:06 -0600
Subject: [PATCH 02/15] cmd ref: update remvoe desc. per
 https://github.com/iterative/dvc/pull/3471#pullrequestreview-377172394

---
 content/docs/command-reference/remove.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/command-reference/remove.md b/content/docs/command-reference/remove.md
index f35498dcba..db63ae521f 100644
--- a/content/docs/command-reference/remove.md
+++ b/content/docs/command-reference/remove.md
@@ -1,6 +1,6 @@
 # remove
 
-Remove data files or directories tracked by DVC.
+Remove DVC-tracked files or directories from the <abbr>workspace</abbr>.
 
 ## Synopsis
 

From 5fc388490e3a942dc5454b00133708fbb1ee344f Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Thu, 19 Mar 2020 00:11:50 -0600
Subject: [PATCH 03/15] cmd ref: update root definition per
 https://github.com/iterative/dvc/pull/3471#pullrequestreview-377173196

---
 content/docs/command-reference/root.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/content/docs/command-reference/root.md b/content/docs/command-reference/root.md
index 04454a16ac..6cbce836c3 100644
--- a/content/docs/command-reference/root.md
+++ b/content/docs/command-reference/root.md
@@ -1,6 +1,6 @@
 # root
 
-Return the relative path to the <abbr>DVC project</abbr>.
+Return the relative path to the root of the <abbr>DVC project</abbr>.
 
 ## Synopsis
 
@@ -11,9 +11,10 @@ usage: dvc root [-h] [-q | -v]
 ## Description
 
 While in sub-directories of the project, sometimes developers may want to refer
-some file belonging to another directory. This command returns relative path to
-the project root from the current working directory. So this command can be used
-to build a path to a dependency file, command, or output.
+some file belonging to another directory. This command returns the path to the
+root directory of the current <abbr>DVC project</abbr>, relative to the current
+working directory. This command can be used to build a path to a dependency
+file, command, or output.
 
 ## Options
 

From 0f10925e7ce7025e4f39bce0d691edb11fa8769b Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Thu, 19 Mar 2020 01:03:09 -0600
Subject: [PATCH 04/15] cmd ref: imros to gc per
 https://github.com/iterative/dvc.org/pull/1023#pullrequestreview-377077194

---
 content/docs/command-reference/gc.md | 10 +++++-----
 1 file changed, 5 insertions(+), 5 deletions(-)

diff --git a/content/docs/command-reference/gc.md b/content/docs/command-reference/gc.md
index e0a275608c..fc543a9b73 100644
--- a/content/docs/command-reference/gc.md
+++ b/content/docs/command-reference/gc.md
@@ -22,11 +22,11 @@ files if no scope options are provided. It means it's user's responsibility to
 explicitly provide the right set of options to specify what data is still needed
 (so that DVC can figure out what fils can be safely deleted).
 
-One of the scope options, `--workspace`, `--all-branches`, `--all-tags`,
-`--all-commits`, or any combination of them must be provided. Each of them
-corresponds to the current workspace _and_ a set of commits to analyze what
-files, directories and what versions are still needed and should be kept (by
-analyzing DVC-files in those commits).
+One of the scope options (`--workspace`, `--all-branches`, `--all-tags`,
+`--all-commits`) or a combination of them must be provided. Each of them
+corresponds to keeping the data for the current workspace, and for a certain set
+of commits (determined by reading the DVC-files in them). See the
+[Options](#options) section for more details.
 
 Unless the `--cloud` option is used, `dvc gc` does not remove data files from
 any remote. This means that any files collected from the local cache can be

From db19c60dfb12a4438144055630a4ba32d965132d Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Thu, 19 Mar 2020 01:12:42 -0600
Subject: [PATCH 05/15] cmd ref: update gc --all-commits desc per
 https://github.com/iterative/dvc.org/pull/1023#discussion_r394824277

---
 content/docs/command-reference/gc.md | 9 +++++----
 1 file changed, 5 insertions(+), 4 deletions(-)

diff --git a/content/docs/command-reference/gc.md b/content/docs/command-reference/gc.md
index fc543a9b73..82895a6ea5 100644
--- a/content/docs/command-reference/gc.md
+++ b/content/docs/command-reference/gc.md
@@ -61,10 +61,11 @@ The default remote is cleaned (see `dvc config core.remote`) unless the
   commits as well as the workspace (implies `-w`). Useful for keeping all the
   data used in the entire existing commit history of the project.
 
-  One of the use cases for this option is to safely delete all temporary data
-  DVC cached when `dvc run` and/or `dvc repro` were run without committing
-  changes to DVC-files (thus potentially caching data that is not referenced
-  from workspace or Git commits).
+  A use case for this option is to safely delete all temporary data `dvc run`
+  and/or `dvc repro` cache when used without committing changes (see the `-O` or
+  `-M`, and `--no-commit` options in those commands). In that scenario, data
+  that is never referenced from the workspace or from any Git commit can still
+  be stored in the project's cache).
 
 - `-p <paths>`, `--projects <paths>` - if a single remote or a single cache is
   shared among different projects (e.g. a configuration like the one described

From 0e21eec4a3903f0eb68380e12b7c7efdc2a93cbf Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Thu, 19 Mar 2020 23:52:13 -0600
Subject: [PATCH 06/15] user-guide: update note about node version for devs
 closes #1078

---
 content/docs/user-guide/contributing/docs.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/content/docs/user-guide/contributing/docs.md b/content/docs/user-guide/contributing/docs.md
index 49f43a5239..7c1a07576d 100644
--- a/content/docs/user-guide/contributing/docs.md
+++ b/content/docs/user-guide/contributing/docs.md
@@ -62,8 +62,8 @@ $ git clone git@github.com:<username>/dvc.org.git
 $ cd dvc.org
 ```
 
-Make sure you have the latest version of [Node.js](https://nodejs.org/en/), and
-install [Yarn](https://yarnpkg.com/):
+Make sure you have a **recent** version of [Node.js](https://nodejs.org/en/),
+and install [Yarn](https://yarnpkg.com/):
 
 ```dvc
 $ npm install -g yarn

From 635d6e992cfb6c135367d517649af037079794a2 Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Fri, 20 Mar 2020 00:54:32 -0600
Subject: [PATCH 07/15] user guide: rec Windows Terminal instead of Cmder

---
 content/docs/user-guide/running-dvc-on-windows.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/content/docs/user-guide/running-dvc-on-windows.md b/content/docs/user-guide/running-dvc-on-windows.md
index 5fbd6245cd..2d0ede9bbf 100644
--- a/content/docs/user-guide/running-dvc-on-windows.md
+++ b/content/docs/user-guide/running-dvc-on-windows.md
@@ -15,10 +15,11 @@ Common Windows terminal alternatives are
 [Anaconda Prompt](https://docs.anaconda.com/anaconda/user-guide/getting-started/#open-prompt-win)
 – but they may not support all the POSIX features (e.g. `\` line continuation).
 
-💡 We recommend the full [Cmder](https://cmder.net/) console emulator (which
-already includes _Git for Windows_).
+💡 We recommend the new
+[Windows Terminal](https://devblogs.microsoft.com/commandline/) for a better
+terminal app experience.
 
-Its also possible to enjoy a full Linux terminal experience with the
+Its also possible to enjoy a full Linux console experience with the
 [WSL](https://blogs.windows.com/windowsdeveloper/2016/03/30/run-bash-on-ubuntu-on-windows/)
 – but it may not be possible to access GPUs from this subsystem.
 

From 64f2dd937c43c554c277985539fd43319126917e Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Tue, 24 Mar 2020 21:57:20 -0600
Subject: [PATCH 08/15] install: add " around special dvc pip paks

---
 content/docs/install/linux.md   | 2 +-
 content/docs/install/macos.md   | 2 +-
 content/docs/install/windows.md | 2 +-
 3 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/content/docs/install/linux.md b/content/docs/install/linux.md
index 5b5ab6c22d..719c62507c 100644
--- a/content/docs/install/linux.md
+++ b/content/docs/install/linux.md
@@ -29,7 +29,7 @@ plan to use, you might need to install optional dependencies: `[s3]`, `[azure]`,
 ### Example: How to install DVC with support for Amazon S3 storage
 
 ```dvc
-$ pip install 'dvc[s3]'
+$ pip install "dvc[s3]"
 ```
 
 In this case it installs `boto3` library as well, besides DVC.
diff --git a/content/docs/install/macos.md b/content/docs/install/macos.md
index 3a231e4647..ebebf0ee62 100644
--- a/content/docs/install/macos.md
+++ b/content/docs/install/macos.md
@@ -47,7 +47,7 @@ plan to use, you might need to install optional dependencies: `[s3]`, `[azure]`,
 ### Example: How to install DVC with support for Amazon S3 storage
 
 ```dvc
-$ pip install 'dvc[s3]'
+$ pip install "dvc[s3]"
 ```
 
 In this case it installs `boto3` library as well, besides DVC.
diff --git a/content/docs/install/windows.md b/content/docs/install/windows.md
index cc2e78e4fe..09f1240563 100644
--- a/content/docs/install/windows.md
+++ b/content/docs/install/windows.md
@@ -53,7 +53,7 @@ plan to use, you might need to install optional dependencies: `[s3]`, `[azure]`,
 ### Example: How to install DVC with support for Amazon S3 storage
 
 ```dvc
-$ pip install 'dvc[s3]'
+$ pip install "dvc[s3]"
 ```
 
 In this case it installs `boto3` library as well, besides DVC.

From 713d327c93d676befe67ece9b783b1a8ad246f32 Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Tue, 24 Mar 2020 22:07:09 -0600
Subject: [PATCH 09/15] cmd ref: address pending review about pre-commit config
 in `install` see
 https://github.com/iterative/dvc.org/pull/1059#pullrequestreview-375723447

---
 content/docs/command-reference/install.md | 13 +++++++------
 1 file changed, 7 insertions(+), 6 deletions(-)

diff --git a/content/docs/command-reference/install.md b/content/docs/command-reference/install.md
index 2898e6823f..faa766670d 100644
--- a/content/docs/command-reference/install.md
+++ b/content/docs/command-reference/install.md
@@ -75,11 +75,11 @@ directory:
 To disable them, you need to **remove** or **edit** those files (i.e.
 `rm .git/hooks/post-checkout`, `vim .git/hooks/pre-commit`).
 
-## Using Pre-Commit tool
+## Using the **pre-commit** tool
 
-DVC provides support for [pre-commit](https://pre-commit.com/) users. To adjust
-`.pre-commit-config.yaml` you could either use
-`dvc install --use-pre-commit-tool`, or add these entries by hand:
+DVC provides support to manage Git hooks with
+[pre-commit](https://pre-commit.com/). To adjust `.pre-commit-config.yaml`, you
+can either use `dvc install --use-pre-commit-tool` or add these entries by hand:
 
 ```yaml
 repos:
@@ -103,8 +103,9 @@ repos:
 
 ## Options
 
-- `--use-pre-commit-tool` - install pre-commit/pre-push/post-checkout hooks into
-  the [pre-commit](https://pre-commit.com/) config (`.pre-commit-config.yaml`).
+- `--use-pre-commit-tool` - installs pre-commit, pre-push, post-checkout Git
+  hooks into the [pre-commit](https://pre-commit.com/) config file
+  (`.pre-commit-config.yaml`).
 
 - `-h`, `--help` - prints the usage/help message, and exit.
 

From 9aea269018eba0e87c9c550b438057772c40d729 Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Wed, 25 Mar 2020 01:16:16 -0600
Subject: [PATCH 10/15] cmd ref: change header in `dvc install` per
 https://github.com/iterative/dvc.org/pull/1072#pullrequestreview-380864131

---
 content/docs/command-reference/install.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/content/docs/command-reference/install.md b/content/docs/command-reference/install.md
index faa766670d..c0ebcf2b9a 100644
--- a/content/docs/command-reference/install.md
+++ b/content/docs/command-reference/install.md
@@ -75,7 +75,7 @@ directory:
 To disable them, you need to **remove** or **edit** those files (i.e.
 `rm .git/hooks/post-checkout`, `vim .git/hooks/pre-commit`).
 
-## Using the **pre-commit** tool
+## Using the Pre-commit tool
 
 DVC provides support to manage Git hooks with
 [pre-commit](https://pre-commit.com/). To adjust `.pre-commit-config.yaml`, you

From 1baa84e9fb2b1a7e2b27a90c0f59c144c033f92f Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Wed, 25 Mar 2020 03:02:15 -0600
Subject: [PATCH 11/15] user-guide: reinstate Cmder rec for Windows terminal
 alts. and... update WSL into note + add WT link per
 https://github.com/iterative/dvc.org/pull/1072#issuecomment-603650701

---
 .../docs/user-guide/running-dvc-on-windows.md | 21 ++++++++++---------
 1 file changed, 11 insertions(+), 10 deletions(-)

diff --git a/content/docs/user-guide/running-dvc-on-windows.md b/content/docs/user-guide/running-dvc-on-windows.md
index 2d0ede9bbf..48922bccd4 100644
--- a/content/docs/user-guide/running-dvc-on-windows.md
+++ b/content/docs/user-guide/running-dvc-on-windows.md
@@ -10,18 +10,19 @@ workarounds that can help avoid these potential problems:
 Many of the DVC commands have POSIX-style options that are given with a double
 dash `--`. This isn't supported by the simple Windows command prompt `cmd`.
 
-Common Windows terminal alternatives are
-[Git Bash](https://gitforwindows.org/#bash) or
-[Anaconda Prompt](https://docs.anaconda.com/anaconda/user-guide/getting-started/#open-prompt-win)
-– but they may not support all the POSIX features (e.g. `\` line continuation).
+💡 We recommend the full [Cmder](https://cmder.net/) console emulator (which
+already includes _Git for Windows_).
 
-💡 We recommend the new
-[Windows Terminal](https://devblogs.microsoft.com/commandline/) for a better
-terminal app experience.
+Other common terminal alternatives for Windows are
+[Git Bash](https://gitforwindows.org/#bash) and
+[Anaconda Prompt](https://docs.anaconda.com/anaconda/user-guide/getting-started/#open-prompt-win)
+– but they may not support all the desired CLI features (e.g. `\` line
+continuation).
 
-Its also possible to enjoy a full Linux console experience with the
-[WSL](https://blogs.windows.com/windowsdeveloper/2016/03/30/run-bash-on-ubuntu-on-windows/)
-– but it may not be possible to access GPUs from this subsystem.
+> You can also try a full Linux console experience enabling
+> [WSL](https://blogs.windows.com/windowsdeveloper/2016/03/30/run-bash-on-ubuntu-on-windows/)
+> ([WT](https://devblogs.microsoft.com/commandline/) is also recommended in this
+> case). But it may be slow and unable to access GPUs from this subsystem.
 
 ## Disable short-file name generation
 

From 03f741111faf4cf60a05bcb50ea3b71f5c6e2472 Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Wed, 25 Mar 2020 17:31:11 -0600
Subject: [PATCH 12/15] user-guide: improve terminal recs for Windows users per
 https://github.com/iterative/dvc.org/pull/1072#pullrequestreview-381452760

---
 content/docs/install/windows.md               |  7 ++-
 .../docs/user-guide/running-dvc-on-windows.md | 49 +++++++++++--------
 2 files changed, 31 insertions(+), 25 deletions(-)

diff --git a/content/docs/install/windows.md b/content/docs/install/windows.md
index 09f1240563..0812719763 100644
--- a/content/docs/install/windows.md
+++ b/content/docs/install/windows.md
@@ -26,7 +26,7 @@ on GitHub.
 
 You can use `conda` from
 [Anaconda Prompt](https://docs.anaconda.com/anaconda/user-guide/getting-started/#open-prompt-win),
-which is a POSIX-like command line terminal in Windows.
+a POSIX-like command line terminal in Windows.
 
 ```dvc
 $ conda install -c conda-forge dvc
@@ -36,9 +36,8 @@ $ conda install -c conda-forge dvc
 
 ## Install with pip
 
-You can install with `pip` from a command line terminal like
-[Git Bash](https://gitforwindows.org/#bash) or
-[WSL](https://blogs.windows.com/windowsdeveloper/2016/03/30/run-bash-on-ubuntu-on-windows/).
+From Command Prompt or other
+[recommended consoles](/doc/user-guide/running-dvc-on-windows):
 
 ```dvc
 $ pip install dvc
diff --git a/content/docs/user-guide/running-dvc-on-windows.md b/content/docs/user-guide/running-dvc-on-windows.md
index 48922bccd4..4e208526af 100644
--- a/content/docs/user-guide/running-dvc-on-windows.md
+++ b/content/docs/user-guide/running-dvc-on-windows.md
@@ -5,24 +5,31 @@ involving system performance. Some, for example, have to do with NTFS file
 system characteristics and Windows built-in security mechanisms. Below are some
 workarounds that can help avoid these potential problems:
 
-## POSIX-like command line shell
-
-Many of the DVC commands have POSIX-style options that are given with a double
-dash `--`. This isn't supported by the simple Windows command prompt `cmd`.
-
-💡 We recommend the full [Cmder](https://cmder.net/) console emulator (which
-already includes _Git for Windows_).
-
-Other common terminal alternatives for Windows are
-[Git Bash](https://gitforwindows.org/#bash) and
-[Anaconda Prompt](https://docs.anaconda.com/anaconda/user-guide/getting-started/#open-prompt-win)
-– but they may not support all the desired CLI features (e.g. `\` line
-continuation).
-
-> You can also try a full Linux console experience enabling
-> [WSL](https://blogs.windows.com/windowsdeveloper/2016/03/30/run-bash-on-ubuntu-on-windows/)
-> ([WT](https://devblogs.microsoft.com/commandline/) is also recommended in this
-> case). But it may be slow and unable to access GPUs from this subsystem.
+## POSIX-like command line experience
+
+The regular Command Prompt (`cmd`) in Windows will most likely not help you use
+DVC effectively, or follow the examples in our docs. Please avoid it. There's no
+perfect solution, bu here are some ideas:
+
+- The full [Cmder](https://cmder.net/) console emulator combines several useful
+  tools like [ConEmu](https://conemu.github.io/), and
+  [Git for Windows](https://gitforwindows.org/)\* (Git Bash) among other
+  [shell options](https://github.com/cmderdev/cmder/blob/master/README.md#access-to-multiple-shells-in-one-window-using-tabs).
+- [Anaconda Prompt](https://docs.anaconda.com/anaconda/user-guide/getting-started/#open-prompt-win)
+  is another recommendation, but it may not support all the desired CLI features
+  (e.g. `\` line continuation).
+- Consider enabling and using
+  [WSL](https://blogs.windows.com/windowsdeveloper/2016/03/30/run-bash-on-ubuntu-on-windows/)
+  ([Windows Terminal](https://devblogs.microsoft.com/commandline/) also
+  recommended). But it may be slow and unable to access GPUs, et al.\*
+- Install an actual Linux distro (e.g. Ubuntu) on a virtual machine, or in a HD
+  partition (dual boot).
+
+> \* Please consult this [solution](https://stackoverflow.com/a/1257613/761963)
+> if you have strange file permission issues with Git for Windows. Also, Running
+> Node apps on WSL may produce
+> [`EACCESS`](https://github.com/microsoft/WSL/issues/3395) file permission
+> issues.
 
 ## Disable short-file name generation
 
@@ -67,6 +74,6 @@ via [Chocolatey](https://chocolatey.org/) (please install the tool first):
 $ choco install less
 ```
 
-`less` can be installed in other ways, just make sure it's available in
-`cmd`/PowerShell, where you run `dvc`. (This usually means adding the directory
-where `less` is installed to the `PATH` environment variable.)
+`less` can be installed in other ways, just make sure it's available in the
+command line environment where you run `dvc`. (This usually means adding the
+directory where `less` is installed to the `PATH` environment variable.)

From 1ebcf18aa6645469f86269b8bff8efacb3dc42e3 Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Wed, 25 Mar 2020 17:43:38 -0600
Subject: [PATCH 13/15] user-guide: remove note about problems with Git on Win
 and Node on WSL per
 https://github.com/iterative/dvc.org/pull/1072#discussion_r398235756

---
 content/docs/user-guide/running-dvc-on-windows.md | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/content/docs/user-guide/running-dvc-on-windows.md b/content/docs/user-guide/running-dvc-on-windows.md
index 4e208526af..4fcae1ee42 100644
--- a/content/docs/user-guide/running-dvc-on-windows.md
+++ b/content/docs/user-guide/running-dvc-on-windows.md
@@ -25,12 +25,6 @@ perfect solution, bu here are some ideas:
 - Install an actual Linux distro (e.g. Ubuntu) on a virtual machine, or in a HD
   partition (dual boot).
 
-> \* Please consult this [solution](https://stackoverflow.com/a/1257613/761963)
-> if you have strange file permission issues with Git for Windows. Also, Running
-> Node apps on WSL may produce
-> [`EACCESS`](https://github.com/microsoft/WSL/issues/3395) file permission
-> issues.
-
 ## Disable short-file name generation
 
 With NTFS, users may want to disable `8dot3` as per

From 9aeaa94e0820a82c9d54566da614bcc06a16b221 Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Wed, 25 Mar 2020 18:18:08 -0600
Subject: [PATCH 14/15] user-guide: update Node supported version per
 https://github.com/iterative/dvc.org/pull/1072#pullrequestreview-380865988

---
 content/docs/user-guide/contributing/docs.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/content/docs/user-guide/contributing/docs.md b/content/docs/user-guide/contributing/docs.md
index 7c1a07576d..3d166ca14f 100644
--- a/content/docs/user-guide/contributing/docs.md
+++ b/content/docs/user-guide/contributing/docs.md
@@ -62,8 +62,8 @@ $ git clone git@github.com:<username>/dvc.org.git
 $ cd dvc.org
 ```
 
-Make sure you have a **recent** version of [Node.js](https://nodejs.org/en/),
-and install [Yarn](https://yarnpkg.com/):
+Make sure you have a recent version of [Node.js](https://nodejs.org/en/)
+(`^12.0.0`), and install [Yarn](https://yarnpkg.com/):
 
 ```dvc
 $ npm install -g yarn
@@ -118,7 +118,7 @@ The first few of the rules below should be enforced automatically by a Git
 pre-commit hook that is integrated when `yarn` installs the project dependencies
 (explained above).
 
-- No trailing whitespaces are allowed.
+- No trailing white spaces are allowed.
 
 - Content must be properly formatted at 80 symbols width.
 

From 1d381eb706b5b11ce6d4f2f333685a986f3eb385 Mon Sep 17 00:00:00 2001
From: Jorge Orpinel <jorge@orpinel.com>
Date: Wed, 25 Mar 2020 18:33:38 -0600
Subject: [PATCH 15/15] user-guide: add links to major WSL problems per
 https://github.com/iterative/dvc.org/pull/1072#issuecomment-603892621

---
 content/docs/user-guide/running-dvc-on-windows.md | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/content/docs/user-guide/running-dvc-on-windows.md b/content/docs/user-guide/running-dvc-on-windows.md
index 4fcae1ee42..ba09225775 100644
--- a/content/docs/user-guide/running-dvc-on-windows.md
+++ b/content/docs/user-guide/running-dvc-on-windows.md
@@ -21,7 +21,10 @@ perfect solution, bu here are some ideas:
 - Consider enabling and using
   [WSL](https://blogs.windows.com/windowsdeveloper/2016/03/30/run-bash-on-ubuntu-on-windows/)
   ([Windows Terminal](https://devblogs.microsoft.com/commandline/) also
-  recommended). But it may be slow and unable to access GPUs, et al.\*
+  recommended). But it has major
+  [I/O performance issues](https://www.phoronix.com/scan.php?page=article&item=windows10-okt-wsl&num=2)
+  and is [unable to access GPUs](https://github.com/Microsoft/WSL/issues/829),
+  et al.\*
 - Install an actual Linux distro (e.g. Ubuntu) on a virtual machine, or in a HD
   partition (dual boot).