dvc.org
dvc.org copied to clipboard
iterative
studio/guide: merge How it Works; flatten Views and Exps
Depends on https://github.com/iterative/dvc.org/pull/3621
-
Merge similar info. from Studio docs homes, How it Works page (gone), and Prepare your repos
- [x] Merge all info about ~~views~~ projects into one guide
- [ ] Merge all info about experiments into another guide
-
[ ] Un-burry guides under UG -> ~~Views~~ Projects and Experiments
Extracted from https://github.com/iterative/dvc.org/pull/3621#pullrequestreview-995958843
@jorgeorpinel Since we've renamed Views to Projects, and since this PR depends on #3621, looks like this isn't straightforward to review. what do you suggest - shall we rebase #3621 and redo changes from this PR?
@tapadipti I'll solve the conflicts but this draft is still incomplete. Not a priority, don't worry about it much now. I know you have more pressing docs needs. We can even close it and reopen/ discuss later. In fact I'd appreciate more any feedback on the plan for this PR as detailed in the description (OP) above.
@shcheklein No, we have not discussed this recently.
@jorgeorpinel it would be good to restructure the docs a bit to "un-bury guides" as you have stated. But in the form in this PR, the pages are going to be quite long. Eg, I looked at the content/docs/studio/user-guide/projects.md page, and it's very long.
I think it'll be good to tackle this in steps - first, let's split the projects and experiments contents. Then, we can improve further.
Also, the following types of changes can be a different PR, coz they aren't about the structure:
Let me know what you think about when we can work this out. I'm currently working on the Live Metrics docs, and the feature is expected to go live in 1 week or so. So any restructuring would have to be done either within 1-2 days or would have to wait until the Live Metrics docs are released.
It'll be easier to start over at this point since there are so many conflicts per other changes to Studio docs.