guide: new DVC Concepts section

[jorgeorpinel]

Per #431 (review)

There should be a section or a few sections called Basic Concepts in the user guide that is/are properly written on a user-level language explaining some concepts. The glossary tooltips could point to these pages too.

we need to explain concepts like Cache, Remote, Wokspace, etc, and their relationships (with diagrams if needed).
From #550 (comment) below

Figure out a connection to glossary tooltips (currently special md files with Frontmatter in content/docs/user-guide/basic-concepts/ — see #1395): Just link to the Concepts? Use a similar engine (with Frontmatter)? Merge completely?

UPDATE: Skip to #550 (comment) for summary

UPDATE: Specific plan

Use contents from #1655 as needed.

• Do we need the changes in package.json, src/components/Documentation/Markdown/Tooltip/index.tsx, src/gatsby/models/glossary/index.js, and src/utils/front/glossary.ts from [WIP] concepts: move from previous docs to new section, etc. #1944 ?
• Workspace (added a BC: workspace document #2197)
• DVC Project (vs. Git/DVC Repository) [guide: DVC Project concept page #2754]
• (from cmd ref) (DVC) Metafiles
• (from cmd ref) DVC/Project Cache
• (from cmd ref) Data Pipeline(s)
• (from cmd ref) Metrics & Plots
• (from cmd ref) Remote (Storage)
• (from cmd ref) Stage
  & update some of the links around this term that currently go to run/stage.
  (Some should link to the future pipelining guide, see guide: Modeling Pipelines #2883)
• (from cmd ref) (Stage) Output
• (from cmd ref) (Stage) Dependency
• Run-Cache?
• Garbage Collection clarifications (in cache or remote pages, see concepts: doc garbage collection in cache and/or remote concept pages #2169)
• Workspace clarifications? Discussed in term: ambiguous use of "external" and "workspace" #1127
• Add Further Reading sections to all Basic Concepts documents? ([v1] misc. (old) cmd ref updates #2127)

---

• Look into glossary: create Glossary page (besides Basic Concepts?) #1395 after or along with this one.
• Consider also a related DVC Principles section (more philosophical, maybe in the Concepts section index)? See guide: new DVC Concepts section #550 (comment) below.
  UPDATE: Maybe use the section index for this or/and What is DVC?.

[jorgeorpinel]

@shcheklein is this not basically the same as #542?

[shcheklein]

@jorgeorpinel iIt might play that role indeed. Let's keep it open anyway and see if a page for the glossary enough or not.

[shcheklein]

• @jorgeorpinel also, this one is related - user-guide: cache/remote/workspace relationships #53 . I though that one can be a part of the Basic Concepts.

[jorgeorpinel]

Perhaps we can call it DVC Principles, similar to:

From https://www.hashicorp.com/products/terraform