docs icon indicating copy to clipboard operation
docs copied to clipboard

use of dark mode tools makes our website and docs difficult to use

Open susanev opened this issue 3 years ago • 3 comments

recently in a usability study a participant was using Dark Reader in Firefox which enables a dark mode, but unfortunately, it made our website and docs difficult to use because a number of things were totally invisible

later on a different community member mentioned they were using chrome dark mode and had a similar experience with components being totally invisible.

dark-mode

as more and more folks enable these dark mode solutions we should figure out if we can make our website/service work with them or if we should be shipping our dark mode

related: https://github.com/pulumi/registry/issues/244

susanev avatar Jun 29 '22 01:06 susanev

My two cents - it's a lot more effort to ship a custom dark mode. However, if employees are using a locked down browser and are unable to add a dark mode extension, or don't want to add a dark mode extension, being able to toggle between light/dark on a website is a huge usability win.

I've also run into the issue w/Pulumi's registry documents working very poorly with Dark Reader for Chrome, however now that I revisit that page to upload a screenshot, it appears that either a change to the extension or to your site's styling has corrected that particular issue.

dgsauve avatar Jul 01 '22 17:07 dgsauve

You should really just add darkmode to your docs and this problem will go away.

XenoWad01 avatar Jun 29 '24 20:06 XenoWad01

The availability of tools like Firefox Reader View and dark mode browser extensions is not a good excuse to not provide a custom dark mode. Those tools are last-ditch attempts to fix accessibility problems with websites. The lack of a dark mode is an accessibility issue. I spend large portions of my day swapping between a terminal, a code editor, the AWS console, and Pulumi docs. Only one of those doesn't ship a dark mode theme. The blast of photons when I switch to a Pulumi docs tab is a physical discomfort.

Modern desktop environments ship with built-in light/dark theme selection options. Modern web browsers persist these settings down into their rendering engines. Modern stylesheets pay attention to those settings to deliver a consistent user experience regardless of the user's preference.

ryanjjung avatar May 08 '25 15:05 ryanjjung