Opinion on the new theme

[ltetrel]

Opinion on the new theme

[pbellec]

I agree with your concerns Loic. Currently readibility and layout are problematic. It would require major tweaking with the theme. The color palette can be made more "neurolibresque", but the colors are indeed quite harsh for notes, warnings etc. At this stage I would also be in favour to go back to the previous theme. Also, I don't think it is a big deal to have different color palettes for the docs and the main website.

[emdupre]

Up to y'all, of course, how you want to handle it. All of the current concerns can be quickly addressed in the conf.py and in some light CSS, but I was trying to have something a bit slicker than the default RTD theme if we'd like to have it clickable from some of the Hugo themes without a significant thematic shit.

I don't think this is my part of the project, though, so I was just offering one option.

[ltetrel]

If we want to have a less thematic shift, maybe we could just change the color palette (from RTD theme) as pierre pointed out ? what do you think @emdupre ? For example with a white background instead of the blue we could keep the original red neurolibre logo

[emdupre]

I don't think just a color change will avoid the thematic shift (although it will be an important part, once the skeleton is finalized). I was looking at e.g. ObservableHQ, which @agahkarakuzu had suggested as one possible inspiration source for NeuroLibre: https://observablehq.com/explore

Their navigation is along the top, much as in the Sphinx-Bootstrap theme -- honestly, it's likely based on Bootstrap itself. If you stick with the RTD theme, you'll switch from a top navbar to a side one, which is a shift no matter the color scheme 😸

Again, though, this isn't really my arena, so only offering options.

[pbellec]

I have never tweaked a sphinx theme, so not sure how much work this will be. I agree with Loic that the RTD theme looks more polished out of the box, but let's see if we can get this sorted. It would be neat to have a consistent style for the docs and the main site. @agahkarakuzu @mathieuboudreau let me know if you would have time / be interested in looking into this. Otherwise I'll try.

[pbellec]

OK so I have slept on this. I don't think it's a good idea to match the style of the docs to the main website. The docs aimed at authors/reviewers should be integrated directly in neurolibre.com. Hugo is perfectly apt to do that, and it will be less confusing than being bounced around different sites. The technical documentation is aimed at developers, and should have its own identity. The content would be limited to https://docs.neurolibre.com/en/latest/INFRASTRUCTURE.html, which would be split into different sections.

[ltetrel]

OK so I have slept on this. I don't think it's a good idea to match the style of the docs to the main website. The docs aimed at authors/reviewers should be integrated directly in neurolibre.com. Hugo is perfectly apt to do that, and it will be less confusing than being bounced around different sites. The technical documentation is aimed at developers, and should have its own identity. The content would be limited to https://docs.neurolibre.com/en/latest/INFRASTRUCTURE.html, which would be split into different sections.

I was exactly thinking the same!

[pbellec]

Based on internal poll, we'll switch back to RTD theme for now. Exact content for docs still in discussion.