4 ms·

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

• thiht 2y ago
  https://api.rubyonrails.org/classes/ActiveJob.html 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"
  • james_marks 2y ago
    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.
  • felipemesquita 2y ago
    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 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.