Merge main into staging

README.md

@@ -101,14 +101,6 @@ When constructing links, refer to the `.qmd` file as Quarto will properly render
 |---|---|
 | `[Get started with JupyterHub](get-started/developer/try-with-jupyterhub.qmd)` | `[Get started with JupyterHub](get-started/developer/try-with-jupyterhub.html)` |
 
-The only exceptions are within HTML, such as CSS-styled buttons which necessitate usage of `.html` href links:
-
-```html
-<a class="btn btn-primary" role="button" style="padding: 12px;color: var(--bs-white);background: #DE257E;border-radius: 4px;margin-top: 40px;font-family: 'Inter';font-style: normal;font-weight: 700;font-size: 14px;line-height: 100%;border: 1px solid var(--bs-pink);" href="get-started/developer/try-with-jupyterhub.html">QuickStart</a>
-```
-
-> You'll need to pay special attention to these links and manually test them to ensure that they are not broken whenever any changes to file destinations are made. 
-
 When constructing filepaths, including while using [Quarto's Includes](https://quarto.org/docs/authoring/includes.html) (single-sourcing feature), you'll also want start with the root directory whenever possible as this minimizes usage of unclear relative paths: 
 
 | Correct | Incorrect |

site/_quarto.yml

@@ -112,6 +112,7 @@ website:
         - text: "---"
         - text: "RELEASES"
         # MAKE-RELEASE-NOTES-EMBED-MARKER
+        - releases/2024-oct-22/release-notes.qmd
         - releases/2024-sep-25/release-notes.qmd
         - releases/2024-sep-09/release-notes.qmd
         - releases/2024-aug-13/release-notes.qmd

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

@@ -119,6 +119,52 @@ Column 2, 50% wide
 - Keep hyperlinks in instructional text minimal — too many links can misdirect the user from the task at hand. 
 - When possible — such as any time instructions are not single-sourced — instead of multiple inline links, make use of margin footnotes.[^5]
 - Whenever possible, make the link the title of the destination article. This also solves the issue of links with nebulous descriptions that do not match article titles, or links whose destinations are not clear to the user such as "Read more." 
+- When constructing links, refer to the `.qmd` file as Quarto will properly render these into `.html` links on your behalf and check to see if the destinations are able to be resolved.
+- When constructing filepaths, you'll also want start with the root directory whenever possible as this minimizes usage of unclear relative paths.
+
+| Correct | Incorrect | 
+|------|-----|
+|   `[Set up model workflows](/guide/model-workflows/set-up-model-workflows.qmd)`  |  `[Learn more ...](/../../set-up-model-workflows.html)`  |
+: **Inline links** examples {.hover}
+
+#### Buttons
+
+Sometimes, it's helpful to highlight a call to action with a button that takes you to a topic or to a notebook on JupyterHub. 
+
+Change any Markdown link into a our theme-styled button by appending `{.button}`:
+
+:::: {.flex .flex-wrap .justify-around}
+
+::: {.w-30-ns}
+**Correct:**  
+
+[Set up model workflows](/guide/model-workflows/set-up-model-workflows.qmd){.button}
+
+```markdown
+[Set up model workflows](/guide/model-workflows/set-up-model-workflows.qmd){.button}
+```
+
+::: {.callout}
+Using a markdown button also enables you to link to to the `.qmd` path instead of the rendered `.html` file.
+:::
+
+:::
+
+::: {.w-60-ns}
+**Incorrect:**
+
+<form method="get" action="../../../guide/model-workflows/set-up-model-workflows.html">
+   <button type="submit" style="color: #de257e; background-color: white; border-radius: 8px; border: none; font-size: 16px; padding: 6.25px 12.5px; margin-left: 16px; margin-bottom: 20px;border: 1px solid #de257e">Set up model workflows</button>
+</form>
+
+```html
+<form method="get" action="../../../guide/model-workflows/set-up-model-workflows.html">
+   <button type="submit" style="color: white; background-color: #de257e; border-radius: 8px; border: none; font-size: 16px; padding: 6.25px 12.5px; margin-left: 16px; margin-bottom: 20px;">Set up model workflows</button>
+</form>
+```
+:::
+
+::::
 
 #### Margin footnotes
 

site/guide/monitoring/ongoing-monitoring.qmd

@@ -34,7 +34,7 @@ Monitoring is a critical component of model risk management, as emphasized in re
 
 
 ::: {.column-margin}
-![Sample monitoring results](target-prediction-distribution-plot-zoomed.png){fig-alt="An image showing sample monitoring results in the ValidMind platform"ç
+![Sample monitoring results](target-prediction-distribution-plot-zoomed.png){fig-alt="An image showing sample monitoring results in the ValidMind platform"}
 :::
 
 

site/index.qmd

@@ -45,12 +45,12 @@ listing:
     sort: false
     fields: [title, description]
     contents:
+      - 2024-oct-22/release-notes.qmd
       - 2024-sep-25/release-notes.qmd
       - 2024-sep-09/release-notes.qmd
       - 2024-aug-13/release-notes.qmd
       - 2024-jul-22/release-notes.qmd
       - 2024-jun-10/release-notes.qmd
-      - 2024-may-22/release-notes.qmd
 ---
 
 ```{=html}