Example for dvc add --to-remote

content/docs/command-reference/add.md

@@ -81,10 +81,8 @@ copy of the target data directly to a remote of your choice (or the default
 one). A `.dvc` file will be created normally, but the data won't be found in
 your local project until you `dvc pull` it.
 
-This option is useful when the local system can't handle the target data, but
-you still want to track and store it in remote storage, so that whenever you
-switch to a different system that can handle it, you can simply pull the data
-and start working on it.
+(ℹ️) See the [Transfer to remote storage](#example-transfer-to-remote-storage)
+below.
 
 ### Adding entire directories
 
@@ -344,3 +342,49 @@ $ tree .dvc/cache
 
 Only the hash values of the `dir/` directory (with `.dir` file extension) and
 `file2` have been cached.
+
+## Example: Transfer to remote storage
+
+When you have a large dataset in an external location, you may want to add it to
+your project without downloading it to the local file system (for using it
+later/elsewhere). The `--to-remote` option let you skip the download, while
+storing the imported data [remotely](/doc/command-reference/remote). Let's
+initialize a DVC project, and setup a remote:
+
+```dvc
+$ mkdir example # workspace
+$ cd example
+$ git init
+$ dvc init
+$ mkdir /tmp/dvc-storage
+$ dvc remote add myremote /tmp/dvc-storage
+```
+
+Now let's add the `data.xml` to our remote storage from the given remote
+location.
+
+```dvc
+$ dvc add https://data.dvc.org/get-started/data.xml -o data.xml \
+                 --to-remote -r myremote
+...
+```
+
+The only difference that dataset is transferred straight to remote, so DVC won't
+control the remote location you gave but rather continue managing your remote
+storage where the data is now on. The operation will still be resulted with an
+`.dvc` file:
+
+```dvc
+$ ls
+data.xml.dvc
+```
+
+Whenever anyone wants to actually download the added data (for example from a
+system that can handle it), they can use `dvc pull` as usual:
+
+```dvc
+ $ dvc pull data.xml.dvc -r tmp_remote
+
+A       data.xml
+1 file added and 1 file fetched
+```

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

@@ -361,8 +361,8 @@ Running stage 'prepare' with command:
 ## Example: Transfer to remote storage
 
 When you have a large dataset in an external location, you may want to import it
-to you project without downloading it to the local file system (for using it
-later/elsewhere). The `--to-remote` option lets you skip the download, while
+to your project without downloading it to the local file system (for using it
+later/elsewhere). The `--to-remote` option let you skip the download, while
 storing the imported data [remotely](/doc/command-reference/remote). Let's
 initialize a DVC project, and setup a remote: