[jimworm]

I wouldn't mind if ruby copied the rails docs style exactly (https://api.rubyonrails.org/), and I'm pretty sure rails wouldn't mind either.

[thiht]

https://api.rubyonrails.org/classes/ActiveJob.html

That one's a bit too much red for my taste :) There's a sweet spot to find that's closer to "nice accent colors" than "aggressive red wall of text"

[felipemesquita]

The rails api docs are also going through a redesign, you can see a preview of the next design in edge: https://edgeapi.rubyonrails.org/classes/ActiveJob.html I think it’s a a change in the right direction that removes the “aggressive wall of text” on longer pages and looks great in dark and light modes.

[james_marks]

The challenge is that if you only sprinkle some red in for accents, the accents look even more like an error. It’s a conundrum.