search

acts-project / vecmem

Vectorised data model base and helper classes.
https://acts-project.github.io/vecmem/
Mozilla Public License 2.0
19 stars 13 forks source link

Introduce doxygen-awesome-css, main branch (2024.06.08.) #280

Closed krasznaa closed 3 months ago

krasznaa commented 3 months ago

I was told about doxygen-awesome-css last week by @EdwardMoyse. And then he even went ahead with introducing it into atlas/athena in https://gitlab.cern.ch/atlas/athena/-/merge_requests/72075. So I thought I should do it for our repository as well. :wink:

What this setup brings is to switch from this sort of documentation pages:

image image image

, to a look like:

image image image

Now... I personally use a dark theme, that's why all the pages show up like this. But they should by default adapt to the viewer's preference I believe. Plus, the claim is that the pages should show up a lot better on phones/tablets. Though this latter I didn't try so far.

I'm actually open to a discussion about this. How do you guys feel about this sort of a look? :thinking:

stephenswat commented 3 months ago

It's certainly better than the default style, although I do prefer the RTD (Sphinx?) format over this.

beomki-yeo commented 3 months ago

I am also fine with the change. The default one looks quite old school