Closed mabruzzo closed 4 months ago
I don't particularly love our current theme so would be happy to change. The readthedocs theme has always seemed nice to me.
I'm glad that there seems to be a consensus around sphinx_rtd_theme. I opened a PR to make this transition.
I wanted to briefly gauge receptiveness to updating the website theme. It's unclear to me whether this something we simply inherited and haven't changed from Enzo or something people feel strongly about.
I've never been a huge fan of the theme current theme, 'agogo' (in particular, I don't think it places enough emphasis on warnings and notes). But the thing that prompted me to make this issue is the formatting of tables. In particular, PR #182 introduces a handful of tables and I strongly dislike the current formatting. Here are 2 examples from the preview read-the-docs builds for that PR here and here.
Honestly, in the absence of any strong opinions, I always like the readthedocs theme. Maybe I'm just used to it, but I always find it visually appealing.
If we feel strongly about using a built-in theme:
We could also consider some other 3rd party themes. If we were willing to entertain larger departures from the existing style, both Material and Bootstrap seem like slick options... (But they may require additional customization to get them to look nice)