Merge pull request #2098 from iterative/2.0/pipelines

DVC File guide reorg/rewrite
iterative · Jan 27, 2021 · d9ce9a3 · d9ce9a3
2 parents 9aac657 + 983a2c3
commit d9ce9a3
Show file tree

Hide file tree

Showing 16 changed files with 568 additions and 793 deletions.
diff --git a/content/docs/command-reference/params/index.md b/content/docs/command-reference/params/index.md
@@ -69,8 +69,8 @@ The `dvc params diff` command is available to show parameter changes, displaying
 their current and previous values.
 
 💡 Parameters can also be used for
-[templating](/doc/user-guide/dvc-files/advanced-dvc.yaml#templating) `dvc.yaml`
-itself.
+[templating](/doc/user-guide/project-structure/pipelines-files#templating)
+`dvc.yaml` itself.
 
 ## Options
 

diff --git a/content/docs/sidebar.json b/content/docs/sidebar.json
@@ -89,34 +89,33 @@
     "children": [
       {
         "label": "What is DVC?",
-        "slug": "what-is-dvc",
-        "source": "what-is-dvc.md"
+        "slug": "what-is-dvc"
       },
       {
-        "label": "DVC Files",
-        "slug": "dvc-files",
+        "slug": "project-structure",
+        "source": "user-guide/project-structure/index.md",
         "children": [
           {
-            "label": ".dvc files",
-            "slug": ".dvc"
+            "label": "Pipelines Files (dvc.yaml)",
+            "slug": "pipelines-files"
           },
           {
-            "label": "dvc.yaml & dvc.lock",
-            "slug": "dvc-yaml"
+            "label": ".dvc Files",
+            "slug": "dvc-files"
           },
           {
-            "label": "Advanced dvc.yaml",
-            "slug": "advanced-dvc-yaml"
+            "label": ".dvcignore Files",
+            "slug": "dvcignore-files",
+            "tutorials": {
+              "katacoda": "https://katacoda.com/dvc/courses/examples/dvcignore"
+            }
+          },
+          {
+            "label": "Internal Files",
+            "slug": "internal-files"
           }
         ]
       },
-      "dvc-internals",
-      {
-        "slug": "dvcignore",
-        "tutorials": {
-          "katacoda": "https://katacoda.com/dvc/courses/examples/dvcignore"
-        }
-      },
       {
         "label": "How To",
         "slug": "how-to",

diff --git a/content/docs/start/data-versioning.md b/content/docs/start/data-versioning.md
@@ -50,9 +50,9 @@ $ dvc add data/data.xml
 
 DVC stores information about the added file (or a directory) in a special `.dvc`
 file named `data/data.xml.dvc`, a small text file with a human-readable
-[format](/doc/user-guide/dvc-files/.dvc). This file can be easily versioned like
-source code with Git, as a placeholder for the original data (which gets listed
-in `.gitignore`):
+[format](/doc/user-guide/project-structure/dvc-files). This file can be easily
+versioned like source code with Git, as a placeholder for the original data
+(which gets listed in `.gitignore`):
 
 ```dvc
 $ git add data/data.xml.dvc data/.gitignore

diff --git a/content/docs/use-cases/versioning-data-and-model-files/tutorial.md b/content/docs/use-cases/versioning-data-and-model-files/tutorial.md
@@ -173,8 +173,8 @@ then `git commit` `.dvc` files that contain file hashes that point to cached
 data.
 
 In this case we created `data.dvc` and `model.h5.dvc`. Refer to
-[DVC Files](/doc/user-guide/dvc-files#dvc-files) to learn more about how these
-files work.
+[DVC Files](/doc/user-guide/project-structure/dvc-files) to learn more about how
+these files work.
 
 </details>
 

diff --git a/content/docs/user-guide/dvc-files.md b/content/docs/user-guide/dvc-files.md