Documentation code sections color scheme

[dvesh3]

Hello Pimconauts 👨‍🚀 👩‍🚀

Currently, we are in the process of improving the Pimcore documentation theme and since, you guys are looking into the docs most the time, your opinion matters the most.

In this poll, we would like to ask you to choose a color scheme for code sections:

1. Light: light background with dark text

2. Dark: Dark background with light text

Thanks for your vote 💜

[NiklasBr]

This is a good argument why light-on-dark should be avoided. as well as this article.

I made the original PR which was accepted and then rejected because I found the light-on-dark to be both of too low contrast and hard to read. It was made worse that the code blocks were dark on an otherwise white page.

[SamyMP]

Why not do both and let the user choose ? As it is done here for example (top right of the screen) : https://sequelize.org/docs/v6/

[jdreesen]

I'd love to have a dark mode (not only the code blocks), too.

[NiklasBr]

Yes, a prefers-color-scheme CSS would resolve it pretty much universally. I could do a PR with that if it is acceptable.

[SamyMP]

That would be great

[dvesh3]

yes, that's a good suggestion 👍 we are happy to receive a PR for the switch 😊