Add dark mode

[TimHess]

Now also available for testing at https://docs-dark.steeltoe.io/ because I'm experiencing what seemed to be a cookie-related issue where theme choice is lost after clicking around to other pages... But that was not the problem - might be that the selection is put in local storage instead of a cookie. Leaving this up anyway for feedback on the dark theme and because I jumped through extra hoops to map a .steeltoe.io name for it

[github-actions]

Preview link: https://docs-steeltoe-pr-344.azurewebsites.net

• Your changes have been deployed to the preview site. The preview site will update as you add more commits to this branch.
• The preview link is shareable, but will be deleted when the pull request is merged or closed.

This is an automated message.

[bart-vmware]

The toggle doesn't stick at https://docs-dark.steeltoe.io/ either.

Readability issue:

Perhaps it's just me, but I find reading the regular color settings peaceful and professional. The dark mode comes across to me as very screamy and aggressive. Compare this with https://www.jsonapi.net/usage/reading/filtering.html, which uses the DocFx default light/dark themes, which are both peaceful.

Can't we just use a generic transform such as here instead of restyling many elements? See also https://radu-matei.com/blog/dark-mode/.

[TimHess]

The toggle doesn't stick at https://docs-dark.steeltoe.io/ either.
Yeah, already noted. There are a couple places in our JS that clear local storage which is probably the reason it doesn't stick, but I've no idea why it does that.

Readability issue:

Perhaps it's just me, but I find reading the regular color settings peaceful and professional. The dark mode comes across to me as very screamy and aggressive. Compare this with https://www.jsonapi.net/usage/reading/filtering.html, which uses the DocFx default light/dark themes, which are both peaceful.

Can't we just use a generic transform such as here instead of restyling many elements? See also https://radu-matei.com/blog/dark-mode/.

I didn't author these commits (just rebased/re-applied them). I also don't love the theme and the readability issue you pointed out probably isn't the only one and I think is part of why the effort stalled out originally

[bart-vmware]

I didn't author these commits (just rebased/re-applied them). I also don't love the theme and the readability issue you pointed out probably isn't the only one and I think is part of why the effort stalled out originally

Well, I'm in favor of keeping things as-is for now and revisiting dark mode when updating to the latest DocFX version.

[TimHess]

will revisit with docfx update