tmp: dvc list proposed output design [DO NOT MERGE]

dvc/command/list/file-path-as-url-0.md

@@ -0,0 +1,5 @@
+```console
+$ cd ~
+$ dvc list  # Default url = .
+ERROR: The current working directory doesn't seem to be part of a DVC project.
+```

dvc/command/list/file-path-as-url-1.md

@@ -0,0 +1,22 @@
+```console
+$ git clone [email protected]:iterative/example-get-started.git
+$ cd example-get-started
+$ dvc list .
+INFO: Listing LOCAL DVC project files, directories, and data at
+      /home/uname/example-get-started/
+
+ 17B 2019-09-20 .gitignore
+6.0K 2019-09-20 README.md
+  9B 2019-09-20 auc.metric
+128B 2019-09-20 data/
+415B 2019-09-20 evaluate.dvc
+367B 2019-09-20 featurize.dvc
+337B 2019-09-20 prepare.dvc
+224B 2019-09-20 src/
+339B 2019-09-20 train.dvc
+5.8M            └ out: (model.pkl)
+
+WARNING: There are missing data files in the given path (shown in parentheses).
+         Use dvc status to review them or dvc pull to download them.
+         See http://man.dvc.org/status and http://man.dvc.org/pull.
+```

dvc/command/list/file-path-as-url-2.md

@@ -0,0 +1,12 @@
+```console
+# Continuation of file-path-as-url-1.md above.
+$ dvc pull featurize.dvc
+$ dvc list featurize.dvc  # With target DVC-file
+INFO: Listing LOCAL DVC project files, directories, and data at
+      /home/uname/example-get-started/
+INFO: Limiting list to data outputs from featurize.dvc stage.
+
+367B 2019-09-20 featurize.dvc
+2.7M            └ out: data/features/test.pkl
+ 11M            └ out: data/features/train.pkl
+```

dvc/command/list/github-url-1-ssh.md

@@ -0,0 +1,13 @@
+```console
+$ dvc list [email protected]:iterative/example-get-started.git  # SSH URL
+ 17B 2019-09-03 .gitignore
+6.0K 2019-09-03 README.md
+  9B 2019-09-03 auc.metric
+128B 2019-09-03 data/
+415B 2019-09-03 evaluate.dvc
+367B 2019-09-03 featurize.dvc
+337B 2019-09-03 prepare.dvc
+224B 2019-09-03 src/
+339B 2019-09-03 train.dvc
+5.8M            └ out: model.pkl
+```

dvc/command/list/github-url-2-http.md

@@ -0,0 +1,6 @@
+```console
+$ dvc list https://github.com/iterative/dataset-registry  # HTTP URL
+1.9K 2019-08-27 README.md
+160B 2019-08-27 get-started/
+128B 2019-08-27 tutorial/
+```

dvc/command/list/github-url-3-recursive.md

@@ -0,0 +1,16 @@
+```console
+$ dvc list --recursive https://github.com/iterative/dataset-registry tutorial  # Recursive inside target dir
+INFO: Limiting list to files and directories in tutorial/
+INFO: Expanding list recursively.
+
+ 29B 2019-08-29 tutorial/nlp/.gitignore
+178B 2019-08-29 tutorial/nlp/Posts.xml.zip.dvc
+ 10M            └ out: tutorial/nlp/Posts.xml.zip
+177B 2019-08-29 tutorial/nlp/pipeline.zip.dvc
+4.6K            └ out: tutorial/nlp/pipeline.zip
+ 26B 2019-08-27 tutorial/ver/.gitignore
+173B 2019-08-27 tutorial/ver/data.zip.dvc
+ 39M            └ out: tutorial/ver/data.zip
+179B 2019-08-27 tutorial/ver/new-labels.zip.dvc
+ 22M            └ out: tutorial/ver/new-labels.zip
+```