term: misc. clarifications

[jorgeorpinel]

Continuation of #448

• Make consistent use of "name.dvc stage file" vs "'name' stage" phrases. (no longer applies in DVC 1.0)
• Look up for phrases like "should", "obvious", "you probably noticed", "as seen here" (without explanation), etc. to make the wording friendlier. Especially in introductory docs and guides (e.g. Get Started) - continued in docs: remove condescending/scary language #1394
• "data remote" / "DVC remote" -> "remote" / "remote storage"?
• "stage file (DVC-file)" -> "stage file (DVC-file with dependencies)"
• Avoid "entry" when in the context of cache files. Use "data", "files", "directories" as appropriate.
• Review usage of "DVC" branding of terms (i/[^`]DVC / regex): Avoid "DVC cache, "DVC pipeline" (others) but keep when necessary, specially "DVC project", "DVC remote" (others)
  UPDATE: Done up to contents/docs/commands-reference/metrics
• review usage of "which"
• avoid "flag" in the context of command options. Favor "option".
• Review usage of "version", "revision", and "reference" per import: docs don't mention that a revision can be a tag/branch #605 (comment)
• GitHb vs. Github (look for similar cases)
• stage output(s) vs. command output (what's printed to stdout)
• stage output vs. data artifacts: they shouldn't be synonyms. Let's just remove "artifact" from the glossary? glossary: remove "data artifact", et al. #1887
• Double check correct usage of singular "metric" vs plural "metrics"
• DAG vs dependency graph and which link to use? https://en.wikipedia.org/wiki/Directed_acyclic_graph vs https://en.wikipedia.org/wiki/Dependency_graph
• Double check correct usage of "metric file" vs "metrics file" (both singular)
• "with Git" -> "to Git" https://trends.google.com/trends/explore?geo=US&q=add%20to%20git,add%20with%20git
• status vs. state
• Decide whether to use term pipeline, DAG, dependency graph, and when, and apply. See docs: replace dvc pipeline with dvc dag #1383 (comment)
• Eliminate "import stage" term. Just use imported .dvc file or something like that

[jorgeorpinel]

See also #552.

[shcheklein]

Can be closed by now?

[jorgeorpinel]

Hmm not really, but this is kind of an epic now that I think about it.

[shcheklein]

@jorgeorpinel are checkboxes up to date?

[jorgeorpinel]

I think so. Will double check

[jorgeorpinel]

OK this is pretty outdated. There's no definite answer in some cases and the terminology goals may continue to evolve so let's just take them as they come.

Cc @casperdcl I feel like you may find this old list interesting 🙂