quickstart: Model Validation (#750)

* WIP validation quickstart

* Validation quickstart draft

* Proofreading

* Quick edit to key concepts

* Edit

* More proofreading

* QuickStart casing fix

* removing future tenses

* common-assets > common-steps

* tabsets

* Update site/get-started/validator/quickstart-validator.qmd

Co-authored-by: Nik Richers <nik@validmind.ai>

* Update site/get-started/validator/quickstart-validator.qmd

Co-authored-by: Nik Richers <nik@validmind.ai>

* Tweak

* Fixing numbering

---------

Co-authored-by: Nik Richers <nik@validmind.ai>

Author: validbeck

site/about/contributing/style-guide/conventions.qmd

@@ -311,7 +311,7 @@ aliases:
 ##### Hotlinked
 
 ```md
-{{{< video https://www.youtube.com/embed/rIR8Mql7eGs?si=vnZA_zP4tAjFjI4r title='ValidMind QuickStart' >}}}
+{{{< video https://www.youtube.com/embed/rIR8Mql7eGs?si=vnZA_zP4tAjFjI4r title='ValidMind Quickstart' >}}}
 ```
 
 ##### Embedded

site/about/contributing/style-guide/voice-and-tone.qmd

@@ -79,7 +79,7 @@ Address the reader directly by using the second person.
 
 | Correct | Incorrect | 
 |------|-----|
-|   After completing this QuickStart, you will be able to view your test results as part of your model documentation right in the {{< var validmind.platform >}}.  |  After completing this QuickStart, the model developer will be able to view the test results as part of the model documentation right in the {{< var validmind.platform >}}.   |
+|   After completing this quickstart, you will be able to view your test results as part of your model documentation right in the {{< var validmind.platform >}}.  |  After completing this quickstart, the model developer will be able to view the test results as part of the model documentation right in the {{< var validmind.platform >}}.   |
 : **2nd person** examples {.hover}
 
 ### Avoid stiff formality

site/about/glossary/key_concepts/_template.qmd

@@ -1,4 +1,7 @@
-template, documentation template
+documentation template
 : Functions as a test suite and lays out the structure of model documentation, segmented into various sections and sub-sections. Documentation templates define the structure of your model documentation, specifying the tests that should be run, and how the results should be displayed.
 
-{{< var vm.product >}} templates come with pre-defined sections, similar to test placeholders, including boilerplates and spaces designated for documentation and test results. When rendered, produces a document that model developers can use for model validation.
+validation report template
+: Serves as a standardized framework for conducting and documenting model validation activities. It outlines the required sections, recommended analyses, and expected validation tests, ensuring consistency and completeness across validation reports. The template helps guide validators through a systematic review process while promoting comparability and traceability of validation outcomes.
+
+    {{< var vm.product >}} templates come with pre-defined sections, similar to test placeholders, including boilerplates and spaces designated for test results, evidence, or findings.

site/developer/samples-jupyter-notebooks.qmd

@@ -40,31 +40,25 @@ Our Jupyter Notebook code samples showcase the capabilities and features of the
 
 ::::
 
-## QuickStart for Customer Churn Model Documentation — Full Suite
+## Quickstarts
 
-Learn how to use dataset and model documentation function on a simple customer churn model. The easiest way to try the QuickStart is on JupyterHub or Google Colaboratory:
+Learn how to develop or validate a simple customer churn model with {{< var vm.product >}}. The easiest way to try the quickstarts are on JupyterHub:
 
 :::: {.flex .flex-wrap .justify-around}
 
 ::: {.w-50-ns}
 
-JupyterHub
-: A a web-based platform when you can interact with Jupyter Notebook instances on a shared server. It is commonly used as a collaborative and interactive computing environment for data analysis, scientific research, and programming.
-
 ::: {.tc}
-[{{< fa code >}} Quickstart on JupyterHub]({{< var url.jupyterhub >}}/hub/user-redirect/lab/tree/quickstart/quickstart_model_documentation.ipynb){.button target="_blank"}
+[{{< fa code >}} Quickstart for model documentation]({{< var url.jupyterhub >}}/hub/user-redirect/lab/tree/quickstart/quickstart_model_documentation.ipynb){.button target="_blank"}
 
 :::
 
 :::
 
 ::: {.w-40-ns}
 
-Google Colaboratory (Colab)
-: A free Jupyter Notebook environment that runs in the cloud. There, you can work with our Jupyter Notebooks by saving your own copy, write and execute code, share your work to collaborate with others in real-time.
-
 ::: {.tc}
-[{{< fa brands google >}} Quickstart on Colab](https://colab.research.google.com/drive/1NLtjCFUZV2I_ttGUkiAL9uwGZK_SGUlw?usp=share_link){.button target="_blank"}
+[{{< fa code >}} Quickstart for model validation]({{< var url.jupyterhub >}}/hub/user-redirect/lab/tree/quickstart/quickstart_model_validation.ipynb){.button target="_blank"}
 
 :::
 

site/developer/validmind-library.qmd

@@ -18,9 +18,6 @@ listing:
     contents:
     - ../notebooks/quickstart/quickstart_model_documentation.ipynb
     - ../notebooks/quickstart/quickstart_model_validation.ipynb
-    # - path: https://youtu.be/rIR8Mql7eGs
-    #   title: "{{< fa brands youtube >}} {{< var vm.product >}} QuickStart"
-    #   description: "Watch the walkthrough on YouTube: `https://youtu.be/rIR8Mql7eGs`"
   - id: model-development
     type: grid
     grid-columns: 2

site/get-started/_sidebar.yaml

@@ -3,7 +3,7 @@ website:
     - id: get-started
       title: "Get Started"
       contents:
-        - text: "Quickstart For"
+        - text: "Quickstarts"
         - text: "Model Development"
           file: get-started/developer/quickstart-developer.qmd
         - text: "Model Validation"

site/get-started/administrator/quickstart-administrator.qmd

@@ -1,14 +1,14 @@
 ---
 title: "Quickstart — Setup & Administration [coming soon]{.smallercaps .pink}"
+subtitle: "10 minutes"
 date: last-modified
-page-layout: full
 ---
 
 Set up the foundational units for your organization within the {{< var validmind.platform >}}, prepare your organization for users, then grant access to your first user.
 
 <!-- BECK'S OUTLINE / NOTES -->
 
-<!-- {{< include /get-started/common-assets/_before-you-begin.qmd >}}
+<!-- {{< include /get-started/common-steps/_before-you-begin.qmd >}}
 
 ## Setting up your organization
 

site/get-started/common-assets/_before-you-begin.qmd

@@ -2,6 +2,6 @@
 
 You can either load the hosted version of our notebook, or download the notebook to run in your own local environment:
 
-#### Load the hosted notebook (recommended)
+#### Open the hosted notebook (recommended)
 
 1. Sign in to [JupyterHub]({{< var url.jupyterhub >}}) with your {{< var vm.product >}} login.

site/get-started/common-assets/_access-quickstart-notebook.qmd renamed to site/get-started/common-steps/_access-quickstart-notebook.qmd

@@ -0,0 +1,8 @@
+::: {.attn}
+
+## {{< fa star-of-life >}} Before you begin
+
+- [x] To try out {{< var vm.product >}}, you need to be a registered user on the {{< var validmind.platform >}}.^[[Register with {{< var vm.product >}}](/guide/configuration/register-with-validmind.qmd)]
+- [x] You'll also want to make sure that you're logged into the {{< var validmind.platform >}}.^[ [Log in to {{< var vm.product >}}](/guide/configuration/log-in-to-validmind.qmd)]
+
+:::