Docs: Docs site theme does not have sufficient color contrast/link contrast

[machikoyasuda]

The Benefits docs site theme, which uses Cal-ITP's default docs theme, is not color contrast sufficient in a few areas:

• The nav bar color background
• The footer text
• The links on white background
• The links should be underlined or visibly distinguished w/o color

I believe the changes need to be made upstream, in this repo, https://github.com/cal-itp/mkdocs-template, but I wanted to document the bug in Benefits first.

To Reproduce

Steps to reproduce the behavior:

1. Go to '...'
2. Run a11y tests

Expected behavior

Ideas:

• Replace the bright blue with Cal-ITP blue for background and links

• Change the footer to be black on white text

• Change the links to be underlined by default

  

• Change it upstream here https://github.com/cal-itp/mkdocs-template so all docs get these changes

• There's a Dark Mode too

• Hopefully it's easy to make these color and link changes w/o too much overriding

[thekaveman]

The settings initially come from https://github.com/cal-itp/mkdocs-template, but that is only a template repo for creating other repos, so making changes there won't automatically reflect out to all other docs sites.

These are OOTB mkdocs-material styles, but there are a lot of customization options: https://squidfunk.github.io/mkdocs-material/customization/

It would be nice to normalize the look and feel with the app itself.