Restructuring docs

[dashohoxha]

I have already started with Katakoda, but it is still WIP:

• https://katacoda.com/dvc/
• https://github.com/dashohoxha/katacoda-dvc-scenarios

If you clone this repo to GitHub - iterative/katacoda-scenarios: Interactive Katacoda Scenarios (or https://github.com/iterative/katacoda-tutorials or something like this), and give me access to it, I can continue working there. Please don’t review it yet until I am done, because I may change and restructure it several times, until I think it is in a good shape.

Please let me finish the Katacoda tutorials first, because this would also help me to get a more intimate knowledge of the details of DVC. Besides this, at the end of November I will have to submit my work to GSoD, and it seems better to submit something that is clearly my work, rather than a bunch of commits that are intermixed with the work of other people.

I think that by the end of this month the Katacoda scenarios will be done, and next month I can start with the User Guide. However it seems that there are several people involved with the docs, and it is not so clear to me what are the responsibilities of each one and what are my responsibilities. I am afraid that we may step onto the toes of each-other if we work on the same files at the same time.

@shcheklein

Re the top level sections. For each of them, I would start by creating a second level section in the User Guide first. Then we will decide which of them it makes sense to move to the top level.

I agree on this.

@shcheklein

Please, use Github and split the plan into some manageable issues/tickets. It’s very hard to discuss and give feedback on 6 large items at once. It’s not good to have two places for this kind of discussions.

I will do it. Right now I am working on this one: build interactive lessons with katacoda · Issue #546 · iterative/dvc.org · GitHub