user-guide/get-started: reorganize "Understanding DVC" section

[jorgeorpinel]

Files currently located in /static/docs/understanding-dvc/

Remove all the Understanding DVC docs and just rescue all that is unique and valuable into the get started and user guide docs.

UPDATES:

• See example actions in user-guide/get-started: reorganize "Understanding DVC" section #425 (comment)
• See deeper discussion (still example based) in user-guide/get-started: reorganize "Understanding DVC" section #425 (comment)

[ryokugyu]

Will you please give an example of this for better understanding? @jorgeorpinel

[shcheklein]

@ryokugyu for example:

How it works - should be reviewed, simplified. made actionable. move to the user guide
What is DVC - reviewed, moved to the user-guide

etc.

[srishti-nema]

I am appending here my ideas about how to reorganize "Understanding DVC", but it is clear that those pages need to be heavily rewritten and updated (not just moved around or relocated on the menu)...

This structure looks good 👍 I was wondering whether we can move The Privacy Policy structure as discussed in #987 (comment) and #144(comment) under one of these sections?

[jorgeorpinel]

Actually that proposal while great when it was done may be outdated right now. The goal now is to reduce the amount of pages and absorb the unique information from Understanding DVC pages into existing User Guide pages as much as possible.

I was wondering whether we can move The Privacy Policy structure as discussed in #987 (comment) and #144(comment) under one of these sections?

Good finds (possibly removing GAPP from footer and from nav sidebar, which is now possible BTW). However, this is all unrelated to this issue.

Also, @srishti-nema as you're already assigned to #540 please focus on that for now.

[VANRao-Stack]

I am appending here my ideas about how to reorganize "Understanding DVC", but it is clear that those pages need to be heavily rewritten and updated (not just moved around or relocated on the menu)...

I have created a similar indexed version of absorbing DVC. I have incorporated certain facts that make it seem more in place, developing from how ML evolved to asking the right questions now. @jorgeorpinel, @shcheklein, if it's okay, should I create a PR?

[shcheklein]

@VANRao-Stack sounds cool! could you outline the changes first?

[jorgeorpinel]

Thanks @VANRao-Stack. I still don't see a specific plan of what parts of Understanding DVC will go where in other existing doc sections. We'd like to see such a "map" as an initial plan. You also seem to have the intention to improve some of the content in question, which isn't bad, but that's not within the scope of this task, just deciding which parts to preserve, moving them, and changing their wording as needed to fit the new context...

How about this, just focus on one page (for example https://dvc.org/doc/understanding-dvc/collaboration-issues) and try to detail where you would move all that content into other sections of the docs, of which parts to just remove and why. You can submit a PR directly if that's easiest for you, or just post another comment with the plan here.

[jorgeorpinel]

OR if you want a small subtask that helps advance this issue, how about this:

• Go over each page and delete content that is 100% redundant with the other existing sections.

For example the first bullet in https://dvc.org/doc/understanding-dvc/how-it-works is pretty much covered in a few places: https://dvc.org/doc/tutorials/get-started/initialize and https://dvc.org/doc/command-reference/init

That should be a well-scoped and relatively easy PR to review.