Formatting of readers in docs

[cbrnr]

Should the readers in the first column on https://sleepecg.readthedocs.io/en/stable/datasets.html get formatted as code (i.e. enclosed in backticks)?

[hofaflo]

Good question, the monospaced font would be nice but I'm not so sure about the color 😅

Now that I think about it, we could select a less striking color for inline code to avoid things like this:

[cbrnr]

Yes, that docstring looks messy. Maybe a grayish color?

[hofaflo]

Like this?

[cbrnr]

Bit hard to read, what about black? Also, why is the "optional" not pink anymore?

I also wonder if the theme we're using supports a dark mode, do you know?

[cbrnr]

Regarding the colors, maybe function/class names should stay pink and monospaced text should be black? But this is probably not possible I assume.

[hofaflo]

Black is better readable, yes!

Dark mode looks like a no(t yet)

The 'optional' changed together with the inline code, I couldn't find an option to prevent this in the default theme.css :/

We could switch to furo, which has a dark mode and displays inline code similar to GitHub. It doesn't have a menu bar at the top though:

[cbrnr]

We could switch to furo

No objection, if you don't mind the missing top navbar I'd say let's do it! I assume the GitHub icon and the RTD version switcher still works?

[hofaflo]

ad navbar: I think it's fine, I'd just put 'API' last as its the only element with a dropdown

ad GitHub: no, but the link could be in the left navigation bar (example)

ad version switcher: that should be part of RTD, so nothing to worry here

[cbrnr]

Fixed in #74.