diff --git a/content/docs/user-guide/what-is-dvc/questions.md b/content/docs/how-to/best-practices.md similarity index 79% rename from content/docs/user-guide/what-is-dvc/questions.md rename to content/docs/how-to/best-practices.md index abdd4b7bf8..3e3db19581 100644 --- a/content/docs/user-guide/what-is-dvc/questions.md +++ b/content/docs/how-to/best-practices.md @@ -1,9 +1,9 @@ -# Common DVC Questions +# Best Practices -Some of these questions are easy to answer individually. Data scientists, -engineers, or managers may already knows or can easily find answers to some of -them. However, the variety of answers and approaches makes data science -collaboration a nightmare. **A systematic approach is required.** +Data scientists, engineers, or managers may already know or can easily find +answers to some of these questions. However, the variety of answers and +approaches makes data science collaboration a nightmare. **A systematic approach +is required.** ## Source code and data versioning diff --git a/content/docs/sidebar.json b/content/docs/sidebar.json index 61a15fe6da..6cb5121359 100644 --- a/content/docs/sidebar.json +++ b/content/docs/sidebar.json @@ -86,7 +86,7 @@ "slug": "what-is-dvc", "label": "What is DVC?", "source": "what-is-dvc/index.md", - "children": ["questions", "core-features", "related-technologies"] + "children": ["core-features", "related-technologies"] }, { "label": "DVC Files and Directories", @@ -140,6 +140,16 @@ } ] }, + { + "slug": "how-to", + "source": false, + "children": [ + { + "slug": "best-practices", + "source": "how-to/best-practices.md" + } + ] + }, { "slug": "command-reference", "source": "command-reference/index.md", diff --git a/content/docs/user-guide/index.md b/content/docs/user-guide/index.md index 601df7f0ef..a7a2f38a84 100644 --- a/content/docs/user-guide/index.md +++ b/content/docs/user-guide/index.md @@ -8,19 +8,16 @@ more parts of DVC, to more advanced and specific things you can do. We also include a few guides related to contributing to [this open-source project](https://github.com/iterative/dvc). -Please choose from the navigation sidebar to the left, or click the `Next` -button below ↘ - ## What is DVC? Even with all the success we've seen today in machine learning (ML), specifically deep learning and its applications in business, the data science community still lacks good practices for organizing their projects and -effectively collaborating across their varied ML projects. This is a critical -challenge: we need to evolve towards ML algorithms and methods no longer being -tribal knowledge and making them easy to implement, reuse, and manage. +collaborating effectively. This is a critical challenge: we need to evolve +towards ML algorithms and methods no longer being tribal knowledge and making +them easy to implement, reuse, and manage. -To make progress, many areas of the ML experimentation process need to be -formalized. Common questions need to be answered in an unified, principled way. +--- -See also these [Common DVC Questions](/doc/user-guide/what-is-dvc/questions)). +Please choose from the navigation sidebar to the left, or click the `Next` +button below ↘