term: stop using "DVC-file" and "stage file"

[jorgeorpinel]

Extracted from #1255

After 1.0, the term DVC-file only refers to raw/initial data versioned with dvc add/import/import-url. however users seem to mostly refer to such files as "dvc file" or .dvc file or just [data].dvc. Since we have all these alternatives, let's remove the formal term DVC-file? Also since there's not dvc.yaml (pipelines file) which adds to the confusion.

We could also address the "import stage" check box from #608:

• Eliminate "import stage" term. Just use imported .dvc file or something like that

I suggest we always use the specific [data].dvc form in our docs.

See these changes as an example of what to do: 1008321

UPDATE: Decided for .dvc file instead. See #1366 (comment) just below.

UPDATE: Similarly, we should stop using "stage file" in favor for .dvc file as well.

UPDATE: Do not include instances in DVC command output examples.

UPDATE: See #1366 (comment) for known progress

[shcheklein]

Agreed. I haven't seen the [data].dvc form though - looks too complicated. We can just use .dvc files - very explicit and clear.

[jorgeorpinel]

@utkarshsingh99 I think this chore is a little too boring TBH, I don't want you to suffer with this any more! Can you just please remind us the list of files that have been done so far up to your 2nd PR (#1408)? Thanks again for the help, BTW! I'll take it from there.

If you want to upload the remaining changes you have to a new branch in your fork and open a draft PR so I can take it over that would also be OK, up to you.

[utkarshsingh99]

Sure.

1. Command Reference

• PR 1 'DVC-file(s)' replaced with '.dvc file(s)' #1372
  • add.md
  • get-url.md
  • get.md
  • init.md
  • move.md
  • repro.md
• PR 2 DVC file -> .dvc file (2nd chunk) reopen #1408
  • fetch.md
  • import.md
  • import-url.md
  • list.md
  • pull.md
  • push.md
  • remove.md
  • status.md
  • update.md

2. API Reference

• PR 1 'DVC-file(s)' replaced with '.dvc file(s)' #1372
  • get_url.md

3. Install

• PR 1 'DVC-file(s)' replaced with '.dvc file(s)' #1372
  • plugins.md

4. User-Guide

• PR 2 DVC file -> .dvc file (2nd chunk) reopen #1408
  • dependency.md
  • dvc-project.md
  • external-dependency.md
  • import-stage.md
  • output.md