On: Ruby's official documentation just got a new look

[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 → jimworm]

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 → thiht]

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 → thiht]

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.