Pulling in latest from main & resolving merge conflicts

Author: validbeck

site/_quarto.yml

@@ -129,6 +129,7 @@ website:
         - text: "---"
         - text: "Releases"
         # MAKE-RELEASE-NOTES-EMBED-MARKER
+        - releases/2024-dec-06/release-notes.qmd
         - releases/2024-oct-22/release-notes.qmd
         - releases/2024-sep-25/release-notes.qmd
         - releases/2024-sep-09/release-notes.qmd

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

@@ -218,14 +218,14 @@ Using a markdown button also enables you to link to to the `.qmd` path instead o
   ```
   | Inline links in training | Footnotes in user guides | 
   |------|-----|
-  | ![](training_inline-links.png){fig-alt="A screenshot showing an example of inline links in training materials" .screenshot} | ![](user-guide_footenotes.png){fig-alt="A screenshot showing an example of margin footnotes in a user guide" .screenshot} |
+  | ![Example of inline links in training materials](training_inline-links.png){fig-alt="A screenshot showing an example of inline links in training materials" .screenshot group="links" .lightbox} | ![Example of margin footnotes in a user guide](user-guide_footenotes.png){fig-alt="A screenshot showing an example of margin footnotes in a user guide" .screenshot group="links" .lightbox} |
   : **Inline vs footnotes links** examples {.hover}
 
 Footnotes will automatically appear in the correct location in the margin, regardless of their origin or format.
 
 | Correct | Incorrect | 
 |------|-----|
-| ![](margin-footnotes_correct.png){fig-alt="A screenshot showing a correct example of footnote links automatically placed in the margin" .screenshot} | ![](inline-links_incorrect.png){fig-alt="A screenshot showing an incorrect example of supplementary links in inline instructional text" .screenshot} |
+| ![Correct example of footnote links automatically placed in the margin](margin-footnotes_correct.png){fig-alt="A screenshot showing a correct example of footnote links automatically placed in the margin" .screenshot group="footnotes" .lightbox} | ![Incorrect example of supplementary links in inline instructional text](inline-links_incorrect.png){fig-alt="A screenshot showing an incorrect example of supplementary links in inline instructional text" .screenshot group="footnotes" .lightbox} |
 : **Margin footnotes** examples {.hover}
 
 ### Emphasis
@@ -516,10 +516,6 @@ Try it **live** on the next page. {{< fa hand-point-right >}}
 
 - Training slides use inline links only instead of footnotes,[^28] as footnotes are not visible in presentation mode.
 
-## What's next
-- [Voice and tone](voice-and-tone.qmd)
-
-
 <!-- FOOTNOTES -->
 
 [^1]: **Wikipedia:** [Progressive disclosure](https://en.wikipedia.org/wiki/Progressive_disclosure)

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

@@ -100,10 +100,6 @@ Keep your audience involved in the process. Engage the reader with questions, an
 |   What if you were able to more easily, more effortlessly discern uncertainty, unleashing the full potential of your model outputs? That’s the power of {{< var vm.product >}}.  |  {{< var vm.product >}} easily and effortlessly discerns uncertainty, unleashing the full potential of model outputs.  |
 : **Audience engagement** examples {.hover}
 
-## What's next
-- [Conventions](conventions.qmd)
-
-
 <!-- FOOTNOTES -->
 
 [^1]: **Microsoft:** [Bias-free communication](https://learn.microsoft.com/en-us/style-guide/bias-free-communication)

site/get-started/get-started.qmd

@@ -7,13 +7,14 @@ aliases:
 listing:
   id: next-steps
   type: grid
+  max-description-length: 250
   grid-columns: 2
   # image-height: 100%
   sort: none
   contents:
     - path: quickstart.qmd
       title: "QuickStart"
-      description: "The fastest way to explore what {{< var vm.product >}} can offer is with our QuickStart — Try out the {{< var validmind.developer >}} and explore the  {{< var validmind.platform >}}."
+      description: "The fastest way to explore what {{< var vm.product >}} can offer is with our QuickStart — Try out the {{< var validmind.developer >}} and explore the {{< var validmind.platform >}}."
     - path: platform/next-steps.qmd
       title: "Next steps"
       description: "If you have already tried the QuickStart, more how-to instructions and links to our FAQs can be found under our next steps."

site/guide/configuration/managing-your-organization.qmd

@@ -5,13 +5,14 @@ listing:
   - id: guides-onboarding
     type: grid
     max-description-length: 250
-    grid-columns: 3
+    grid-columns: 2
     sort: false
     fields: [title, description]
     contents:
     - set-up-your-organization.qmd
     - configure-aws-privatelink.qmd
     - configure-google-private-service-connect.qmd
+    - configure-azure-private-link.qmd
 ---
 
 Access to the {{< var validmind.platform >}} is associated with an organization, which encompasses all your users, groups, and business units. As a user, you can belong to multiple organizations.

site/guide/configuration/register-with-validmind.qmd

@@ -71,7 +71,7 @@ Choose this method if you intend to set up your organization for your institutio
     - From: `no-reply@validmind.ai`
     - Subject: "Verify your email"
 
-![Verification email sent by {{< var vm.product >}}](verify-email.png){width=80% fig-alt="Screenshot of the verification email sent by ValidMind" .screenshot}
+![Verification email sent by {{< var vm.product >}}](verify-email.png){width=80% fig-alt="Screenshot of the verification email sent by ValidMind" .screenshot group="verify"}
 
 ::: {.column-margin}
 If you cannot locate this email, you may need to review your spam or junk mail folders and filters, or request that your IT allow-list our owned domains or retrieve any messages sent by:
@@ -81,7 +81,7 @@ b. `validmind.com`
 :::
 
 ::: {.column-margin}
-![Confirmation of email verification](email-verified.png){fig-alt="Screenshot of the confirmation of email verification" .screenshot}
+![Confirmation of email verification](email-verified.png){fig-alt="Screenshot of the confirmation of email verification" .screenshot  group="verify"}
 :::
 
 8. Click **<u>Confirm my account</u>** to gain full access to {{< var vm.product >}}.
@@ -92,10 +92,12 @@ b. `validmind.com`
 
 :::: {.flex .flex-wrap .justify-around}
 ::: {.w-40-ns}
-![{{< var vm.product >}}'s main dashboard](main-dashboard.png){fig-alt="Screenshot of the main ValidMind dashboard" .screenshot}
+![{{< var vm.product >}}'s main dashboard](main-dashboard.png){fig-alt="Screenshot of the main ValidMind dashboard" .screenshot group="validmind"}
+
 :::
 ::: {.w-40-ns}
-![Sample models populated by {{< var vm.product >}}](sample-models.png){fig-alt="Screenshot of the sample models populated by ValidMind" .screenshot}
+![Sample models populated by {{< var vm.product >}}](sample-models.png){fig-alt="Screenshot of the sample models populated by ValidMind" .screenshot group="validmind"}
+
 :::
 ::::
 
@@ -125,10 +127,10 @@ b. `validmind.com`
 
 3. On the page that opens up in your web browser, click **Accept Invitation**.
 
-![{{< var vm.product >}} accept invitation to join an organization screen](organization-accept-invitation.png){width=80% fig-alt="Screenshot of the ValidMind accept invitation to join an organization screen" .screenshot}
+![{{< var vm.product >}} accept invitation to join an organization screen](organization-accept-invitation.png){width=80% fig-alt="Screenshot of the ValidMind accept invitation to join an organization screen" .screenshot group="accept"}
 
 ::: {.column-margin}
-![{{< var vm.product >}} signup welcome screen](signup-welcome-screen.png){width=90% fig-alt="Screenshot of the ValidMind signup welcome screen" .screenshot}
+![{{< var vm.product >}} signup welcome screen](signup-welcome-screen.png){width=90% fig-alt="Screenshot of the ValidMind signup welcome screen" .screenshot group="accept"}
 :::
 
 4. On the Welcome screen, enter your email address and input a secure, unique password, or choose one of the single sign-on options to link to your account:
@@ -146,7 +148,7 @@ Make sure that the email or account you use to link to {{< var vm.product >}} is
     - From: `no-reply@validmind.ai`
     - Subject: "Verify your email"
 
-![Verification email sent by {{< var vm.product >}}](verify-email.png){width=80% fig-alt="Screenshot of the verification email sent by ValidMind" .screenshot}
+![Verification email sent by {{< var vm.product >}}](verify-email.png){width=80% fig-alt="Screenshot of the verification email sent by ValidMind" .screenshot group="accept-verify"}
 
 ::: {.column-margin}
 If you cannot locate this email, ou may need to review your spam or junk mail folders and filters, or request that your IT allow-list our owned domains or retrieve any messages sent by:
@@ -156,7 +158,8 @@ b. `validmind.com`
 :::
 
 ::: {.column-margin}
-![Confirmation of email verification](email-verified.png){fig-alt="Screenshot of the confirmation of email verification" .screenshot}
+![Confirmation of email verification](email-verified.png){fig-alt="Screenshot of the confirmation of email verification" .screenshot group="accept-verify"}
+
 :::
 
 6. Click **<u>Confirm my account</u>** to gain full access to {{< var vm.product >}}.
@@ -167,10 +170,12 @@ b. `validmind.com`
 
 :::: {.flex .flex-wrap .justify-around}
 ::: {.w-40-ns}
-![{{< var vm.product >}}'s main dashboard](main-dashboard.png){fig-alt="Screenshot of the main ValidMind dashboard" .screenshot}
+![{{< var vm.product >}}'s main dashboard](main-dashboard.png){fig-alt="Screenshot of the main ValidMind dashboard" .screenshot group="dashboard"}
+
 :::
 ::: {.w-40-ns}
-![Sample models populated by ValidMind](sample-models.png){fig-alt="Screenshot of the sample models populated by ValidMind" .screenshot}
+![Sample models populated by ValidMind](sample-models.png){fig-alt="Screenshot of the sample models populated by ValidMind" .screenshot group="dashboard"}
+
 :::
 ::::
 

site/guide/model-documentation/work-with-content-blocks.qmd

@@ -115,11 +115,11 @@ When generating content drafts with AI, accepted versions and edits are retained
 
    - In the toolbar for text blocks
 
-   ![Deleting a content block via the text toolbar](remove-text-block.gif){fig-alt="A gif showing the process of deleting a content block via the text toolbar" .screenshot}
+   ![Deleting a content block via the text toolbar](remove-text-block.gif){fig-alt="A gif showing the process of deleting a content block via the text toolbar" .screenshot group="delete"}
 
    - In the single-button toolbar for test-driven or metric over time blocks
 
-   ![Deleting a content block via the single-button toolbar for test-driven blocks](remove-test-driven-block.gif){fig-alt="A gif showing the process of deleting a content block via the single-button toolbar for test-driven blocks" .screenshot}
+   ![Deleting a content block via the single-button toolbar for test-driven blocks](remove-test-driven-block.gif){fig-alt="A gif showing the process of deleting a content block via the single-button toolbar for test-driven blocks" .screenshot group="delete"}
 
 
 6. After you confirm, the content block is removed. 

site/guide/model-inventory/configure-model-interdependencies.qmd

@@ -62,13 +62,13 @@ Once applied, model interdependencies will populate on all models linked togethe
 
 ::: {.w-40-ns}
 
-![Upstream Model linked to the downstream Current Model](upstream-model.png){fig-alt="A screenshot showing the Upstream Model linked to the downstream Current Model" .screenshot}
+![Upstream Model linked to the downstream Current Model](upstream-model.png){fig-alt="A screenshot showing the Upstream Model linked to the downstream Current Model" .screenshot group="interdependency"}
 
 :::
 
 ::: {.w-40-ns}
 
-![Downstream Model linked to the upstream Current Model](downstream-model.png){fig-alt="A screenshot showing the Downstream Model linked to the upstream Current Model" .screenshot}
+![Downstream Model linked to the upstream Current Model](downstream-model.png){fig-alt="A screenshot showing the Downstream Model linked to the upstream Current Model" .screenshot group="interdependency"}
 
 :::
 

site/guide/model-inventory/manage-model-inventory-fields.qmd

@@ -65,13 +65,13 @@ Number
 
 ::: {.w-50-ns}
 
-![Simple number field type](number-simple.png){fig-alt="A screenshot showing a simple number field type" .screenshot} 
+![Simple number field type](number-simple.png){fig-alt="A screenshot showing a simple number field type" .screenshot group="number"} 
 
 :::
 
 ::: {.w-40-ns}
 
-![Currency number field type](number-currency.png){fig-alt="A screenshot showing a currency number field type" .screenshot}
+![Currency number field type](number-currency.png){fig-alt="A screenshot showing a currency number field type" .screenshot group="number"}
 
 :::
 
@@ -94,7 +94,7 @@ User
 - Select list pre-populated with users from your {{< fa book-open >}} User Directory.[^4] 
 - Toggle [allow linking to multiple records]{.smallcaps} on to allow multi-selection of users.
 
-Calculation
+Calculation <span id="calculation"></span> 
 : Define a `formula(params)` function that automatically calculates and returns a value based on the params dictionary, which includes selected custom field keys retrieved from your other inventory model fields.
 
     1. Click **{{< fa plus >}}** in front of the inventory field to allow your formula access to the field's values.

site/guide/model-validation/_assess-compliance-assess.qmd

@@ -18,11 +18,11 @@
 
    For example, to indicate that there is some compliance based on the evidence or findings you linked to:
 
-   ![Validation report section 2.1.1. that shows a compliance assessment with the option to link to finding](/guide/model-validation/assess-compliance.png){fig-alt="A screenshot of the validation report section 2.1.1. that shows a compliance assessment with the option to link to finding" .screenshot}
+   ![Validation report section 2.1.1. that shows a compliance assessment with the option to link to finding](/guide/model-validation/assess-compliance.png){fig-alt="A screenshot of the validation report section 2.1.1. that shows a compliance assessment with the option to link to finding" .screenshot group="compliance"}
 
    Confirm that the compliance summary shown for each subsection under 2. Validation provides an accurate overview for current qualitative and quantitative risk assessments:
 
-   ![Risk assessment compliance summary](/guide/model-validation/assess-compliance-summary.png){fig-alt="A screenshot of the risk assessment compliance summary" .screenshot}
+   ![Risk assessment compliance summary](/guide/model-validation/assess-compliance-summary.png){fig-alt="A screenshot of the risk assessment compliance summary" .screenshot group="compliance"}
 
 ::::
 
@@ -44,11 +44,11 @@
 
    For example, to indicate that there is some compliance based on the evidence or findings you linked to:
 
-   ![Validation report section 2.1.1. that shows a compliance assessment with the option to link to finding](/guide/model-validation/assess-compliance.png){fig-alt="A screenshot of the validation report section 2.1.1. that shows a compliance assessment with the option to link to finding" .screenshot}
+   ![Validation report section 2.1.1. that shows a compliance assessment with the option to link to finding](/guide/model-validation/assess-compliance.png){fig-alt="A screenshot of the validation report section 2.1.1. that shows a compliance assessment with the option to link to finding" .screenshot group="compliance"}
 
    Confirm that the compliance summary shown for each subsection under 2. Validation provides an accurate overview for current qualitative and quantitative risk assessments:
 
-   ![Risk assessment compliance summary](/guide/model-validation/assess-compliance-summary.png){fig-alt="A screenshot of the risk assessment compliance summary" .screenshot}
+   ![Risk assessment compliance summary](/guide/model-validation/assess-compliance-summary.png){fig-alt="A screenshot of the risk assessment compliance summary" .screenshot group="compliance"}
 
 ::::