-
Notifications
You must be signed in to change notification settings - Fork 394
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add an index page with pointers to the interactive lessons #650
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
See my comments. It's probably good opportunity to introduce the new level in the - Tutorials. And we need to come with a better name, Learn is too generic.
The way that I see the DVC journey of a new user is like this:
That's why I proposed to put a link to https://katacoda.com/dvc/courses/basics on the top menu. Maybe we can use the button "Get Started" (on the top-right of the page) for this purpose. |
I think I've addressed this a little bit in a few other tickets. Also, the way I see any tutorial on a third-party resource - it's a complimentary but not a replacement for the main get started flow. The entry point should stay on dvc.org in a text form - I think it's a regular approach for the docs. Also, I think the current "Katacoda" basics course is too complicated already (like XFS intro, It would be great to have a button to go and experiment with each get started section online. To some extent the My suggestion is to make it a part of the Tutorials + put links to different parts of it where appropriate. When it has some parity in terms of simplicity and completes (introduces more or less all basic features of DVC) we can put a link to the very beginning of the current get started. We should try and put a button "Run online" to each get started DVC section.
the same here. I do see a lot of benefits having it in a runnable form, but it should be integrated properly into the text version, not replace it. Again, dependency on a third-party service is bad, not being able to just read the text (I would prefer to skim through one single page in many cases) is bad, limited ability to present the information (highlighting, linking to command reference) is bad. |
I have actually had in mind something like this. I am going to do this next. Just created this issue: #664 |
I am going to create soon a top level entry for Tutorials. I am going to link these interactive lessons from the index page of the Tutorials. We can change this structure later if needed. Related: #657 |
Closing this in favor of #666 |
Related issues (some of them may be closed after inspection):