Docs site audit part 2 - inline link cleanup

[validbeck]

External Release Notes

For sc-4898, I:

• Added vm_login to the _variables.yml file & changed all instances of "1. [Log in to the {{< var vm_platform >}}]({{< var vm_url >}})." to "1. Log in to the {{< var vm_login >}}."
• Adjusted the hacky CSS on customize-documentation-templates.qmd to match the new link styling applied in PR#217
• Established a convention in the style guide for .column-margin content and used this to pull out extraneous links from step-by-step instructions or text
• Reviewed extraneous bolding of links where appropriate
• Retooled the "About ValidMind" landing page to include "Automated testing & documentation" & "Model risk governance management" (removed the "Features" section from About)

Major changes

variables.yml

Added vm_login: "[ValidMind Platform UI](https://app.prod.validmind.ai)"

• Changed all instances of "1. [Log in to the {{< var vm_platform >}}]({{< var vm_url >}})." to "1. Log in to the {{< var vm_login >}}."
• For some articles that did not have the first login step but required it, I made a quick adjustment as I was working

Customize documentation templates

Adjusted the hacky CSS on customize-documentation-templates.qmd to match the new link styling applied in PR#217

.column-margin content

New section in the style guide for inline links/margin content rationale & guidance:

• Reviewed all articles for extraneous links, especially in step-by-step instructions and applied this new margin styling instead when appropriate (or did not mess with single-sourced training, etc.):

Old	New

About

Retooled the "About ValidMind" landing page to include "Automated testing & documentation" & "Model risk governance management" (removed the "Features" section from About)

• Now there are some fancy cards under "ValidMind AI risk platform" with links out to the relevant docs instead of the nebulous Read more ...
• The two linked pages got some quick cleanup as well to remove the Read more ...s

Page	Old	New
About ValidMind
Automated testing & documentation
Model risk governance management

Other changes

Following our own rules about minimizing callouts and unnecessary repeats of text and tricky conditional displays etc.

Page	Old	New
Review model documentation
Collaborate with others

Other notes

I noticed that some images don't have alt text as per our style guide so I will add that to the list for the next review.

• I'm going to wait until Noosheen's PR Updated docs for roles and permissions #219 is merged into main so I can pull in those changes and do a final pass before merging this PR. EDIT: DONE :) Thanks Noosheen!

[nrichers]

LGTM! My only comment is that we should use bullets OR superscript numbers but not both. I'd globally change callouts to look like this:

[validbeck]

@nrichers:

Just removed the numeration from this page:

Removed the bullet points from any pages with margin lists: