Developer portal — Quick reshuffle to accomodate "ValidMind for model development" series

[validbeck]

Internal Notes for Reviewers

sc-8728

Get started with the ValidMind Library > ValidMind Library

LIVE PREVIEW

• To accommodate for strengthening this section of our docs site into our hub for resources/references for the library instead of more sprawling content that should be corralled into our upcoming Get Started/onboarding restructure, I've renamed this section — especially as it's actually much more than a "Getting Started" page.
  • We have a habit of having multiple copies/using the same terminology for discrete content/ideas so let's improve that when we can.
  • I made sure to include an alias and resolve any direct links in the doc, also this follow-up PR in validmind-library for notebook links out and references to the title for cleanliness: Cleanup of links out to the ValidMind Library docs validmind-library#331
• This landing page got a slight edit, in addition to plunking in the new introductory series. Shortened the conceptual pieces in preparation for a bigger edit when we have a Story for giving this section the TLC it deserves.
  • QuickStart section simplified a bit — we still have the old video here for now but it's a link out instead of a video tile that overwhelms the page.
  • The abstract "Document models" listing with more conceptual fluff is now a What's next-ish section, directing users to the guides on how to continue after logging tests and generating documentation. No nonsense and to the point.

Before	After

Model documentation > QuickStart

New sidebar section. We explain so much more than just model documentation, for one, and this restrictive model documentation-sans-model-validation focus doesn't leave room for us building on these resources for a validation experience.

Supported models

Moved this into just under the landing as it's technically a conceptual/product reference and fixed all links out/added an alias.

Documenting models

• I removed this conceptual fluff and the Document models flow page as it is superfluous. IMO, developer docs should be about doing or learning by doing and not pages and pages of essays about how the product works in theory. Hopefully as we continue to clean up our notebooks the how will no longer be in question.
• The more granular guides (Install & initialize, Store credentials, etc.) remain for now just in case as I do believe they are important reference materials in piecemeal outside of the notebooks where we also link out to these docs, but placed them in the new QuickStart section of the sidebar.
  • "Work with test results" got moved into "Working with model documentation" where it actually belongs — with the rest of the granular platform user guides!

Before	After

Introduction for model developers > ValidMind for model development series

The star of the show — now in its own sidebar section and a step under the QuickStart notebook (which I plan to edit next to complement the series!).

Sidenav	Landing page tiles

Also, a "ValidMind for model validation" would fit right in here now whenever it's ready! ✨

Other notes

• I cleaned up our relative aliases as I realised Quarto is able to resolve those fine for clarity. My bad for not checking on this before (or maybe they updated it recently, idk).
• There were also some relative hotlinks to images in the training — fixed those.

FAQ migrated into Support

• There was agreement here that this should just happen so I took the opportunity while I was reshuffling to move this for cleaner nav/more condensed sections.
• I left the folder structure untouched as we have releases separate as well even though they're in About — just compressed the user end of things.

Before	After

Try the code samples

Changed the button to All code samples but I'm not convinced these are best/most helpful three samples we have at the moment — just some food for thought... might need to wait until we clean up our notebooks/restructure them, but it did stand out to me.