Quickstart docs site improvements

[nrichers]

Internal Notes for Reviewers

While working on our first QuickStart video, I realized we can speed up the user journey. Here are a couple of short videos to demo the difference:

• Old QuickStart experience — 5 clicks, plus you need to figure out where to go
• New QuickStart experience — 2 clicks

Also includes are some minor text edits to highlight that you're learning how to document a model.

EDIT: I needed this to be live to record QuickStart videos, so don't be surprised if you look at our docs site and see the new experience already.

External Release Notes

We reworked our QuickStart experience to shorten the number of clicks it takes to get you started. You can now access the QuickStart from the home page or our docs site and we direct you to the preferred Jupyter Hub version right away. Try it ...

[validbeck]

Nice! Overall I like the changes, especially having the button on the Landing Page.

Website docs link

• We may want to change our WP website so that the documentation link takes you to the Landing instead of https://docs.validmind.ai/guide/get-started.html, as that is where it currently takes you when you click on Documentation, but I think we wanted to retool this section landing anyhow...

JupyterHub

• We're directing users to JupyterHub instead of giving them a choice between the tools, is this because this is the lowest bar for entry?
• I also don't see the updated notebook with the "Get your code snippet" header when I click on the link out to Jupyter after pulling down the PR and previewing with Quarto, has this not been replaced yet? (Sidenote: How does one replace that notebook? Do I have access to do that?)

EDIT: Also, I tried testing this with my personal Google account to see if it would let me access the notebook, and it doesn't — not sure if that will be an issue for users that are just curious.

Google Colab

• We should probably think about updating the Colab notebook with the ToC as well (and get that bug about the preview of the template not working fixed: sc-4123)

[nrichers]

• We may want to change our WP website so that the documentation link takes you to the Landing instead of https://docs.validmind.ai/guide/get-started.html

Yes, that would make a lot of sense since it's just a general link to our docs site. Can you follow up on that, @validbeck? We should just link to https://docs.validmind.ai/.

We're directing users to JupyterHub instead of giving them a choice between the tools, is this because this is the lowest bar for entry?

Technically, they can still choose but we've taken out the semantic load out of having to parse the the getting started and choosing.

I also don't see the updated notebook with the "Get your code snippet" header when I click on the link out to Jupyter after pulling down the PR and previewing with Quarto, has this not been replaced yet? (Sidenote: How does one replace that notebook? Do I have access to do that?)

It'll require validmind/validmind-library#71 to be merged but I am still tweaking that a bit. Deployment to Jupyter Hub involves Andres at the moment, I don't have access to that.

[validbeck]

Can you follow up on that, @validbeck? We should just link to https://docs.validmind.ai/.

Done!

It'll require validmind/validmind-library#71 to be merged but I am still tweaking that a bit. Deployment to Jupyter Hub involves Andres at the moment, I don't have access to that.

Makes sense, all roads lead to Rome Andres ;)

[nrichers]

• We should probably think about updating the Colab notebook with the ToC as well (and get that bug about the preview of the template not working fixed: sc-4123)

I put that story into Sprint 50 with a pointer to validmind/validmind-library#71.