Update documentation styling

[ghislaineguerin]

Updates Documentation Styles to match new marketing site:

NOW:

BEFORE:

[seancolsen]

I just want to point out that this PR targets develop which means it won't get published until our next release. That's fine with me. But if anyone else wants this to get published sooner, we'll need to cherry-pick these commits on top of master.

[kgodey]

@ghislaineguerin This looks great! Feedback

1. Can you please double check the styling of admonitions and code blocks (see old vs. new below)?
   • Please also check on light mode.
2. I would maybe also consider adding some color to headings.
3. I would consider differentiating the left sidebar menu and the right sidebar menu a bit more.

Admonition

Code Block

[kgodey]

See comment.

[ghislaineguerin]

@kgodey I've pushed additional styling changes. I'm not sure if you wanted me to completely change the admonitions or fix anything in particular?

[zackkrida]

@ghislaineguerin I looked at the code blocks and admonitions and I think they look good 👍

I had a question about font size. I feel like the new fonts are "bigger" at the same font size value as the previous site, and that the new styles look a lot better if the base font size is reduced from .8em to .7em:

Old site (.8em)

New site (.8em)

New site (.7em)

What do you think?

I also think we can probably merge this at this point, once you're replied about the font size.

[ghislaineguerin]

@zackkrida I agree about the font size, I'm ok with making that change and merging it.

[zackkrida]

@ghislaineguerin I made the change and merged; thanks!