diff --git a/src/Documentation/sidebar.json b/src/Documentation/sidebar.json
index 06d60fc747..490b28539e 100644
--- a/src/Documentation/sidebar.json
+++ b/src/Documentation/sidebar.json
@@ -104,6 +104,16 @@
       ],
       "move.md",
       ["pipeline.md", "pipeline_list.md", "pipeline_show.md"],
+      [
+        "pkg.md",
+        "pkg_install.md",
+        "pkg_uninstall.md",
+        "pkg_add.md",
+        "pkg_remove.md",
+        "pkg_modify.md",
+        "pkg_list.md",
+        "pkg_import.md"
+      ],
       "push.md",
       "pull.md",
       [
@@ -157,6 +167,14 @@
       "pipeline.md": "pipeline",
       "pipeline_list.md": "pipeline list",
       "pipeline_show.md": "pipeline show",
+      "pkg.md": "pkg",
+      "pkg_install.md": "pkg install",
+      "pkg_uninstall.md": "pkg uninstall",
+      "pkg_add.md": "pkg add",
+      "pkg_remove.md": "pkg remove",
+      "pkg_modify.md": "pkg modify",
+      "pkg_list.md": "pkg list",
+      "pkg_import.md": "pkg import",
       "destroy.md": "destroy",
       "unprotect.md": "unprotect",
       "cache.md": "cache",
diff --git a/static/docs/commands-reference/cache b/static/docs/commands-reference/cache
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/static/docs/commands-reference/cache_dir.md b/static/docs/commands-reference/cache_dir.md
index a784779afa..0a27a53305 100644
--- a/static/docs/commands-reference/cache_dir.md
+++ b/static/docs/commands-reference/cache_dir.md
@@ -33,7 +33,8 @@ file, as they are expected in the config file.
   specify private config options in your config, that you don't want to track
   and share through Git.
 
-- `-u`, `--unset` - remove a specified config option from a config file.
+- `-u`, `--unset` - remove the `cache.dir` config option from the config file.
+  Don't provide a `value` when using this flag.
 
 - `-h`, `--help` - prints the usage/help message, and exit.
 
diff --git a/static/docs/commands-reference/config.md b/static/docs/commands-reference/config.md
index d5eed01f6d..1e784bf525 100644
--- a/static/docs/commands-reference/config.md
+++ b/static/docs/commands-reference/config.md
@@ -15,7 +15,7 @@ positional arguments:
 
 You can query/set/replace/unset DVC configuration options with this command. It
 takes a config option `name` (a section and a key, separated by a dot) and its
-`value`.
+`value` (any valid alpha-numeric string generally).
 
 This command reads and overwrites the DVC config file `.dvc/config`. If
 `--local` option is specified, `.dvc/config.local` is modified instead.
@@ -168,6 +168,12 @@ more about the state file that is used for optimization.
   so that when it needs to cleanup the database it could sort them by the
   timestamp and remove the oldest ones. Default quota is set to 50(percent).
 
+### pkg
+
+These are sections in the config file that describe specific
+[DVC packages](/doc/commands-reference/pkg). These sections contain the `url`
+and `_cwd` keys, which values are used internally by the `dvc pkg` commands.
+
 ## Examples: Core config options
 
 Set the `dvc` log level to `debug`:
diff --git a/static/docs/commands-reference/metrics b/static/docs/commands-reference/metrics
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/static/docs/commands-reference/pipeline b/static/docs/commands-reference/pipeline
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/static/docs/commands-reference/pkg.md b/static/docs/commands-reference/pkg.md
new file mode 100644
index 0000000000..06bd883714
--- /dev/null
+++ b/static/docs/commands-reference/pkg.md
@@ -0,0 +1,44 @@
+# pkg
+
+A set of commands to to manage DVC packages:
+[install](/doc/commands-reference/pkg-install),
+[uninstall](/doc/commands-reference/pkg-uninstall),
+[add](/doc/commands-reference/pkg-add),
+[remove](/doc/commands-reference/pkg-remove),
+[modify](/doc/commands-reference/pkg-modify),
+[list](/doc/commands-reference/pkg-list), and
+[import](/doc/commands-reference/pkg-import).
+
+## Synopsis
+
+```usage
+usage: dvc pkg [-h | -q | -v]
+               {install,uninstall,add,remove,modify,list,import} ...
+
+positional arguments:
+  {install,uninstall,add,remove,modify,list,import}
+                        Use dvc pkg CMD --help for command-specific help.
+    install             Install package(s).
+    uninstall           Uninstall package(s).
+    add                 Add package.
+    remove              Remove package.
+    modify              Modify package.
+    list                List packages.
+    import              Import data from package.
+```
+
+## Description
+
+Manage DVC packages. See `dvc pkg install`.
+
+Any DVC project can be used as a DVC package in order to reuse its code, stages,
+and related data artifacts in the current project workspace.
+
+## Options
+
+- `-h`, `--help` - prints the usage/help message, and exit.
+
+- `-q`, `--quiet` - does not write anything to standard output. Exit with 0 if
+  no problems arise, otherwise 1.
+
+- `-v`, `--verbose` - displays detailed tracing information.
diff --git a/static/docs/commands-reference/pkg_add.md b/static/docs/commands-reference/pkg_add.md
new file mode 100644
index 0000000000..dfb5f47197
--- /dev/null
+++ b/static/docs/commands-reference/pkg_add.md
@@ -0,0 +1,82 @@
+# pkg add
+
+Add a DVC package. The package is registered in the DVC project configuration.
+
+See also [install](/doc/commands-reference/pkg-install),
+[uninstall](/doc/commands-reference/pkg-uninstall),
+[remove](/doc/commands-reference/pkg-remove),
+[modify](/doc/commands-reference/pkg-modify),
+[list](/doc/commands-reference/pkg-list), and
+[import](/doc/commands-reference/pkg-import).
+
+## Synopsis
+
+```usage
+usage: dvc pkg add [-h] [--global] [--system] [--local] [-q | -v] [-f]
+                   [name] url
+
+positional arguments:
+  name           Package name.
+  url            Package URL.
+```
+
+## Description
+
+Any DVC project can be used as a DVC package in order to reuse its code, stages,
+and related data artifacts in the current project workspace.
+
+A valid `url` should be either an HTTP or SSH Git repository address such as
+`https://github.com/iterative/example-get-started` or
+`git@github.com:iterative/example-get-started.git` respectively – corresponding
+to our sample [get started](/doc/get-started) DVC project. Note that
+`dvc pkg add` does NOT validate the URL at this point, however inexistent or
+unreachable addresses will result in a failure of the package
+[install](/doc/commands-reference/pkg-install) and
+[import](/doc/commands-reference/pkg-import) commands.
+
+A `name` is required to identify the package configuration in the DVC project.
+Such name can be any valid continuous alpha-numeric string like `my-pkg_name`.
+However, the `name` argument is optional as it can be extracted from the `url`
+path. If the name is already registered (check with `dvc pkg list`), the package
+`url` is overwritten.
+
+Adding a package registers it in the DVC config file (typically in `.dvc/config`
+– see `dvc config`). Note that nothing is downloaded from the package URL. (Use
+`dvc pkg install` or `dvc pkg import` to actually get files from the package).
+
+## Options
+
+- `-f`, `--force` - to overwrite existing package with new `url` value.
+
+- `--global` - modify a global config file (e.g. `~/.config/dvc/config`) instead
+  of the project's `.dvc/config`.
+
+- `--system` - modify a system config file (e.g. `/etc/dvc.config`) instead of
+  `.dvc/config`.
+
+- `--local` - modify a local config file instead of `.dvc/config`. It is located
+  in `.dvc/config.local` and is Git-ignored. This is useful when you need to
+  specify private config options in your config, that you don't want to track
+  and share through Git.
+
+- `-h`, `--help` - prints the usage/help message, and exit.
+
+- `-q`, `--quiet` - does not write anything to standard output. Exit with 0 if
+  no problems arise, otherwise 1.
+
+- `-v`, `--verbose` - displays detailed tracing information.
+
+## Example
+
+```dvc
+$ dvc pkg add get-started https://github.com/iterative/example-get-started
+```
+
+Results in the DVC config file (typically `.dvc/config`) being appended a `pkg`
+section like:
+
+```ini
+['pkg "get-started"']
+url = https://github.com/iterative/example-get-started
+_cwd = /Users/username/dvcproject/.dvc
+```
diff --git a/static/docs/commands-reference/pkg_import.md b/static/docs/commands-reference/pkg_import.md
new file mode 100644
index 0000000000..6e37f2d58c
--- /dev/null
+++ b/static/docs/commands-reference/pkg_import.md
@@ -0,0 +1,104 @@
+# pkg import
+
+Import a data artifact from a DVC package.
+
+See also [uninstall](/doc/commands-reference/pkg-uninstall),
+[add](/doc/commands-reference/pkg-add),
+[remove](/doc/commands-reference/pkg-remove),
+[modify](/doc/commands-reference/pkg-modify),
+[list](/doc/commands-reference/pkg-list), and
+[import](/doc/commands-reference/pkg-import).
+
+## Synopsis
+
+```usage
+usage: dvc pkg import [-h] [-q | -v] pkg_name pkg_path [out]
+
+positional arguments:
+  pkg_name       Package name.
+  pkg_path       Path to data in the package.
+  out            Destination path to put data to.
+```
+
+## Description
+
+Any DVC project can be used as a DVC package in order to reuse its code, stages,
+and related data artifacts in the current project workspace.
+
+When importing data from a package, the provided name (`pkg_name`) can be
+previously registered with `dvc pkg add`. The first thing that this command does
+is to install the package in `.dvc/pkg/{pkg_name}`. (See `dvc pkg install` for
+more details.)
+
+The provided name (`pkg_name`) may also be the URL to the location of the DVC
+package (same as `url` in `dvc pkg add`), in that case, the implicit package
+name will be extracted from the given address and used for the package
+installation.
+
+> Note that like with installing, importing data from a package with implicit
+> names does NOT add the package to the config file.
+
+`pkg_path` is the path to the data artifact in the package after its `url` root
+`/`, such as `scripts/innosetup/dvc.ico` (see [example](#example) below). A data
+artifact is any one output defined in a DVC-file in the package. Note that since
+these data artifacts are controlled by DVC and not by the SCM system (e.g. Git),
+they can't be found by browsing the code repository. This command has to read
+the package configuration to connect to a remote of that project in order to
+fetch the data file to the local cache, and "check it out" (see `dvc checkout`)
+it to the current project's workspace.
+
+Data artifacts are placed in the current working directory with the same file
+name as the original output from the package. To use custom path and file name
+instead, and optional `out` argument can be used with this command.
+
+Finally, the data import process creates a DVC-file in the same location as the
+imported data, specifying the package dependency for the imported data similar
+as to having added the imported data with `dvc add`. This way `dvc repro` will
+be able to reproduce the import operation as a regular stage in this project's
+pipeline.
+
+## Options
+
+- `-h`, `--help` - prints the usage/help message, and exit.
+
+- `-q`, `--quiet` - does not write anything to standard output. Exit with 0 if
+  no problems arise, otherwise 1.
+
+- `-v`, `--verbose` - displays detailed tracing information.
+
+# Example
+
+```dvc
+$ mkdir import && cd import
+$ dvc pkg import https://github.com/iterative/dvc scripts/innosetup/dvc.ico
+Preparing to collect status from https://dvc.org/s3/dvc
+...
+```
+
+Will find the `dvc.ico` file in the output of a stage file in the
+https://github.com/iterative/dvc package and import it into the current working
+dir (`import/`).
+
+```dvc
+$ ls
+dvc.ico     dvc.ico.dvc
+```
+
+The `dvc.ico.dvc` file contents should look something like:
+
+```ini
+md5: 7aac042f559753a470723d44b2384a61
+wdir: .
+deps:
+- md5: 90104d9e83cfb825cf45507e90aadd27
+  path: scripts/innosetup/dvc.ico
+  pkg:
+    name: dvc
+    url: https://github.com/iterative/dvc
+outs:
+- md5: 90104d9e83cfb825cf45507e90aadd27
+  path: dvc.ico
+  cache: true
+  metric: false
+  persist: false
+```
diff --git a/static/docs/commands-reference/pkg_install.md b/static/docs/commands-reference/pkg_install.md
new file mode 100644
index 0000000000..99b71a6c0e
--- /dev/null
+++ b/static/docs/commands-reference/pkg_install.md
@@ -0,0 +1,94 @@
+# pkg install
+
+Install DVC package(s).
+
+See also [uninstall](/doc/commands-reference/pkg-uninstall),
+[add](/doc/commands-reference/pkg-add),
+[remove](/doc/commands-reference/pkg-remove),
+[modify](/doc/commands-reference/pkg-modify),
+[list](/doc/commands-reference/pkg-list), and
+[import](/doc/commands-reference/pkg-import).
+
+## Synopsis
+
+```usage
+usage: dvc pkg install [-h] [-q | -v] [targets [targets ...]]
+
+positional arguments:
+  targets        Package name.
+```
+
+## Description
+
+Any DVC project can be used as a DVC package in order to reuse its code, stages,
+and related data artifacts in the current project workspace.
+
+When installing a package, the provided name(s) (`targets`) can be previously
+registered with `dvc pkg add`. Each name will be created as a subdirectory of
+`.dvc/pkg/`, where the corresponding package source files (code and DVC-files)
+will be placed. (`.dvc/pkg/` will be added to the `.dvc/.gitignore` file if
+needed.)
+
+The provided `targets` may also be URLs to the location of the DVC packages
+(same as `url` in `dvc pkg add`), in that case, the implicit package name will
+be extracted from the given address and used for the subdirectory of `.dvc/pkg/`
+as explained in the previous paragraph.
+
+> Note that installing packages with implicit names does NOT add them to the
+> config file.
+
+## Options
+
+- `-h`, `--help` - prints the usage/help message, and exit.
+
+- `-q`, `--quiet` - does not write anything to standard output. Exit with 0 if
+  no problems arise, otherwise 1.
+
+- `-v`, `--verbose` - displays detailed tracing information.
+
+## Examples: With an implicit package name
+
+Having a DVC project in https://github.com/iterative/example-get-started
+
+```dvc
+$ dvc pkg install https://github.com/iterative/example-get-started
+...
+```
+
+The result is the `example-get-started` package fully installed in the
+`.dvc/pkg/` directory.
+
+```dvc
+$ tree .dvc/pkg
+.dvc/pkg
+└── example-get-started
+    ├── README.md
+    ├── auc.metric
+    ├── data
+    │   └── data.xml.dvc
+    ├── evaluate.dvc
+    ├── featurize.dvc
+    ├── prepare.dvc
+    ├── requirements.txt
+    ├── src
+    │   ├── evaluate.py
+    │   ├── featurization.py
+    │   ├── prepare.py
+    │   └── train.py
+    └── train.dvc
+```
+
+## Examples: Having added the package first
+
+Having the same DVC project in https://github.com/iterative/example-get-started
+as in the previous example:
+
+```dvc
+$ dvc pkg add https://github.com/iterative/example-get-started
+$ dvc pkg install example-get-started
+...
+```
+
+Same result as the previous example, except that additionally, the DVC config
+file (typically `.dvc/config` will contain a `['pkg "example-get-started"']`
+section due to the `dvc pkg add` command above.
diff --git a/static/docs/commands-reference/pkg_list.md b/static/docs/commands-reference/pkg_list.md
new file mode 100644
index 0000000000..9974bf15ce
--- /dev/null
+++ b/static/docs/commands-reference/pkg_list.md
@@ -0,0 +1,51 @@
+# pkg list
+
+List DVC packages that have been previously added.
+
+See also [install](/doc/commands-reference/pkg-install),
+[uninstall](/doc/commands-reference/pkg-uninstall),
+[add](/doc/commands-reference/pkg-add),
+[remove](/doc/commands-reference/pkg-remove),
+[modify](/doc/commands-reference/pkg-modify),
+[list](/doc/commands-reference/pkg-list), and
+[import](/doc/commands-reference/pkg-import).
+
+## Synopsis
+
+```usage
+usage: dvc pkg list [-h] [--global] [--system] [--local] [-q | -v]
+```
+
+## Description
+
+This command accepts no arguments. It reads the appropriate config file (see the
+command options) and lists the packages specified in its `pkg` sections. (See
+also `dvc config`.)
+
+## Options
+
+- `--global` - modify a global config file (e.g. `~/.config/dvc/config`) instead
+  of the project's `.dvc/config`.
+
+- `--system` - modify a system config file (e.g. `/etc/dvc.config`) instead of
+  `.dvc/config`.
+
+- `--local` - modify a local config file instead of `.dvc/config`. It is located
+  in `.dvc/config.local` and is Git-ignored. This is useful when you need to
+  specify private config options in your config, that you don't want to track
+  and share through Git.
+
+- `-h`, `--help` - prints the usage/help message, and exit.
+
+- `-q`, `--quiet` - does not write anything to standard output. Exit with 0 if
+  no problems arise, otherwise 1.
+
+- `-v`, `--verbose` - displays detailed tracing information.
+
+## Example
+
+```dvc
+$ dvc pkg add get-started https://github.com/iterative/example-get-started
+$ dvc pkg list
+get-started
+```
diff --git a/static/docs/commands-reference/pkg_modify.md b/static/docs/commands-reference/pkg_modify.md
new file mode 100644
index 0000000000..246030a696
--- /dev/null
+++ b/static/docs/commands-reference/pkg_modify.md
@@ -0,0 +1,64 @@
+# pkg modify
+
+Modify DVC package settings.
+
+See also [install](/doc/commands-reference/pkg-install),
+[uninstall](/doc/commands-reference/pkg-uninstall),
+[add](/doc/commands-reference/pkg-add),
+[remove](/doc/commands-reference/pkg-remove),
+[list](/doc/commands-reference/pkg-list), and
+[import](/doc/commands-reference/pkg-import).
+
+## Synopsis
+
+```usage
+usage: dvc pkg modify [-h] [--global] [--system] [--local] [-q | -v]
+                      [-u] name option [value]
+
+positional arguments:
+  name           Package name.
+  option         Option.
+  value          Value.
+```
+
+## Description
+
+Package `name` and `option` name are required.
+
+This command modifies a `pkg` section in the DVC
+[config file](/doc/user-guide/dvc-files-and-directories). Alternatively,
+`dvc config` or manual editing could be used to change settings.
+
+## Options
+
+- `-u`, `--unset` - delete configuration value for given `option`. Don't provide
+  a `value` when using this flag.
+
+- `--global` - modify a global config file (e.g. `~/.config/dvc/config`) instead
+  of the project's `.dvc/config`.
+
+- `--system` - modify a system config file (e.g. `/etc/dvc.config`) instead of
+  `.dvc/config`.
+
+- `--local` - modify a local config file instead of `.dvc/config`. It is located
+  in `.dvc/config.local` and is Git-ignored. This is useful when you need to
+  specify private config options in your config, that you don't want to track
+  and share through Git.
+
+- `-h`, `--help` - prints the usage/help message, and exit.
+
+- `-q`, `--quiet` - does not write anything to standard output. Exit with 0 if
+  no problems arise, otherwise 1.
+
+- `-v`, `--verbose` - displays detailed tracing information.
+
+## Example
+
+```dvc
+$ dvc pkg add example-get-started https://github.com/username/example-get-started
+$ dvc pkg modify example-get-started https://github.com/iterative/example-get-started
+```
+
+The above command first registers a `example-get-started` with the URL of the
+username's fork of the original repository from "iterative", and then corrects
+the mistake.
diff --git a/static/docs/commands-reference/pkg_remove.md b/static/docs/commands-reference/pkg_remove.md
new file mode 100644
index 0000000000..4c65da86fc
--- /dev/null
+++ b/static/docs/commands-reference/pkg_remove.md
@@ -0,0 +1,76 @@
+# pkg remove
+
+Remove a DVC package. Undoes the [adding](/doc/commands-reference/pkg-add) of a
+package.
+
+See also [install](/doc/commands-reference/pkg-install),
+[uninstall](/doc/commands-reference/pkg-uninstall),
+[add](/doc/commands-reference/pkg-add),
+[modify](/doc/commands-reference/pkg-modify),
+[list](/doc/commands-reference/pkg-list), and
+[import](/doc/commands-reference/pkg-import).
+
+## Synopsis
+
+```usage
+usage: dvc pkg remove [-h] [--global] [--system] [--local] [-q | -v]
+                      name
+
+positional arguments:
+  name           Package name.
+```
+
+## Description
+
+The `name` of the package must have been previously registered with the
+[add](/doc/commands-reference/pkg-add) or
+[install](/doc/commands-reference/pkg-install) commands previously.
+
+> Keep in mind that the use of this command should match the cache location
+> options used at the time of adding the package
+> (`[--global] [--system] [--local]`).
+
+This command removes the package from the DVC config file (typically in
+`.dvc/config`). It does NOT remove any files that may have been downloaded by
+`dvc pkg install`. (See `dvc pkg uninstall` for that purpose.)
+
+> Try not to remove a package before its uninstalled, as the `.dvc/pkg/` folder
+> may end up with directories that have to be removed manually.
+
+## Options
+
+- `--global` - modify a global config file (e.g. `~/.config/dvc/config`) instead
+  of the project's `.dvc/config`.
+
+- `--system` - modify a system config file (e.g. `/etc/dvc.config`) instead of
+  `.dvc/config`.
+
+- `--local` - modify a local config file instead of `.dvc/config`. It is located
+  in `.dvc/config.local` and is Git-ignored. This is useful when you need to
+  specify private config options in your config, that you don't want to track
+  and share through Git.
+
+- `-h`, `--help` - prints the usage/help message, and exit.
+
+- `-q`, `--quiet` - does not write anything to standard output. Exit with 0 if
+  no problems arise, otherwise 1.
+
+- `-v`, `--verbose` - displays detailed tracing information.
+
+## Example
+
+Having the `get-started` package added in the example of `dvc pkg add`:
+
+```dvc
+$ dvc pkg list
+get-started	https://github.com/iterative/example-get-started
+```
+
+The following command deletes the `pkg` section for the `get-started` package
+from the DVC config file:
+
+```dvc
+$ dvc pkg remove get-started https://github.com/iterative/example-get-started
+```
+
+(Try `cat .dvc/config` to confirm.)
diff --git a/static/docs/commands-reference/pkg_uninstall.md b/static/docs/commands-reference/pkg_uninstall.md
new file mode 100644
index 0000000000..476b5294b2
--- /dev/null
+++ b/static/docs/commands-reference/pkg_uninstall.md
@@ -0,0 +1,50 @@
+# pkg uninstall
+
+Uninstall DVC package(s).
+
+See also [install](/doc/commands-reference/pkg-install),
+[add](/doc/commands-reference/pkg-add),
+[remove](/doc/commands-reference/pkg-remove),
+[modify](/doc/commands-reference/pkg-modify),
+[list](/doc/commands-reference/pkg-list), and
+[import](/doc/commands-reference/pkg-import).
+
+## Synopsis
+
+```usage
+usage: dvc pkg uninstall [-h] [-q | -v] [targets [targets ...]]
+
+positional arguments:
+  targets        Package name.
+```
+
+## Description
+
+Provided package directory name(s) (`targets`) will be searched for in the
+`.dvc/pkg/` directory and completely removed if found.
+
+> Note that this command does NOT remove the package records from the DVC config
+> file. See `dvc pkg remove` for that purpose.
+
+## Options
+
+- `-h`, `--help` - prints the usage/help message, and exit.
+
+- `-q`, `--quiet` - does not write anything to standard output. Exit with 0 if
+  no problems arise, otherwise 1.
+
+- `-v`, `--verbose` - displays detailed tracing information.
+
+## Example
+
+Having installed the `example-get-started` package from the example in
+`dvc pkg install`:
+
+```dvc
+$ ls -l .dvc/pkg/
+example-get-started
+$ dvc pkg uninstall example-get-started
+```
+
+Results in the `.dvc/pkg/example-get-started/` directory being completely
+removed.
diff --git a/static/docs/commands-reference/remote b/static/docs/commands-reference/remote
deleted file mode 100644
index e69de29bb2..0000000000
diff --git a/static/docs/commands-reference/remote_add.md b/static/docs/commands-reference/remote_add.md
index 9c9f597018..29c2ec8d35 100644
--- a/static/docs/commands-reference/remote_add.md
+++ b/static/docs/commands-reference/remote_add.md
@@ -1,8 +1,9 @@
 # remote add
 
-Add a new data remote. Depending on your storage type you might need to run
-`dvc remote modify` to provide credentials and/or configure other remote
-parameters.
+Add a new data remote.
+
+> Depending on your storage type, you may also need `dvc remote modify` to
+> provide credentials and/or configure other remote parameters.
 
 See also [default](/doc/commands-reference/remote-default),
 [list](/doc/commands-reference/remote-list),
@@ -76,6 +77,8 @@ Use `dvc config` to unset/change the default remote as so:
 
 - `-f`, `--force` - to overwrite existing remote with new `url` value.
 
+## Examples
+
 <details>
 
 ### Click for a local remote example
@@ -309,9 +312,9 @@ $ export OSS_ACCESS_KEY_SECRET='AccessKeySecret'
 
 </details>
 
-## Examples
+## Examples: Custom configuration of an S3 remote
 
-Add AWS S3 _default_ (via `-d` option) remote and modify its region:
+Add a AWS S3 remote as the _default_ (via `-d` option), and modify its region:
 
 ```dvc
 $ dvc remote add -d myremote s3://mybucket/myproject
@@ -320,7 +323,7 @@ Setting 'myremote' as a default remote.
 $ dvc remote modify myremote region us-east-2
 ```
 
-DVC config file would look like (run `cat .dvc/config`):
+DVC config file (`.dvc/config`) now looks like this:
 
 ```ini
 ['remote "myremote"']
@@ -330,7 +333,7 @@ region = us-east-2
 remote = myremote
 ```
 
-And list of remotes like this:
+The list of remotes should now be:
 
 ```dvc
 $ dvc remote list
@@ -338,13 +341,13 @@ $ dvc remote list
 myremote	s3://mybucket/myproject
 ```
 
-You can overwrite existing remote using `-f` with `dvc remote add` as under:
+You can overwrite existing remotes using `-f` with `dvc remote add`:
 
 ```dvc
 $ dvc remote add -f myremote s3://mybucket/mynewproject
 ```
 
-List remotes to view the updated remote:
+List remotes again to view the updated remote:
 
 ```dvc
 $ dvc remote list
diff --git a/static/docs/commands-reference/remote_default.md b/static/docs/commands-reference/remote_default.md
index 9cdd4d481a..e4e6ce72fb 100644
--- a/static/docs/commands-reference/remote_default.md
+++ b/static/docs/commands-reference/remote_default.md
@@ -1,8 +1,9 @@
 # remote default
 
-To set/unset default data remote. Depending on your storage type you may need to
-run `dvc remote modify` to provide credentials and/or configure other remote
-parameters.
+Set/unset a default data remote.
+
+> Depending on your storage type, you may also need `dvc remote modify` to
+> provide credentials and/or configure other remote parameters.
 
 See also [add](/doc/commands-reference/remote-add),
 [list](/doc/commands-reference/remote-list),
diff --git a/static/docs/commands-reference/remote_modify.md b/static/docs/commands-reference/remote_modify.md
index 6d1325bf87..44bce46396 100644
--- a/static/docs/commands-reference/remote_modify.md
+++ b/static/docs/commands-reference/remote_modify.md
@@ -2,6 +2,10 @@
 
 Modify remote settings.
 
+> This command is commonly needed after `dvc remote add` or
+> [default](/doc/commands-reference/remote-default) to setup credentials or
+> other customizations to each remote type.
+
 See also [add](/doc/commands-reference/remote-add),
 [default](/doc/commands-reference/remote-default),
 [list](/doc/commands-reference/remote-list), and
@@ -10,9 +14,8 @@ See also [add](/doc/commands-reference/remote-add),
 ## Synopsis
 
 ```usage
-usage: dvc remote modify [-h] [-q | -v] [-u]
-                       [--global] [--system] [--local]
-                       name option [value]
+usage: dvc remote modify [-h] [--global] [--system] [--local] [-q | -v]
+                         [-u] name option [value]
 
 positional arguments:
  name           Name of the remote
@@ -26,13 +29,14 @@ Remote `name` and `option` name are required. Option names are remote type
 specific. See below examples and a list of per remote type - AWS S3, Google
 cloud, Azure, SSH, ALiyun OSS, and others.
 
-This command modifies a section in the DVC
+This command modifies a `remote` section in the DVC
 [config file](/doc/user-guide/dvc-files-and-directories). Alternatively,
 `dvc config` or manual editing could be used to change settings.
 
 ## Options
 
-- `-u`, `--unset` - delete configuration value
+- `-u`, `--unset` - delete configuration value for given `option`. Don't provide
+  a `value` when using this flag.
 
 - `--global` - save remote configuration to the global config (e.g.
   `~/.config/dvc/config`) instead of `.dvc/config`.
@@ -46,6 +50,8 @@ This command modifies a section in the DVC
   config, that you don't want to track and share through Git (credentials,
   private locations, etc).
 
+## Examples
+
 <details>
 
 ### Click for AWS S3 available options
@@ -252,7 +258,7 @@ $ dvc remote modify myremote oss_endpoint endpoint
 
 </details>
 
-## Examples
+## Examples: Customize an S3 remote
 
 Let's first set up a _default_ S3 remote:
 
diff --git a/static/docs/commands-reference/remote_remove.md b/static/docs/commands-reference/remote_remove.md
index cb368b799b..9cdf7e627a 100644
--- a/static/docs/commands-reference/remote_remove.md
+++ b/static/docs/commands-reference/remote_remove.md
@@ -1,7 +1,7 @@
 # remote remove
 
 Remove a specified remote. This command affects DVC configuration files only, it
-does not physically remove your data files stored remotely.
+does not physically remove data files stored remotely.
 
 See also [add](/doc/commands-reference/remote-add),
 [default](/doc/commands-reference/remote-default),