djangoproject.com icon indicating copy to clipboard operation
djangoproject.com copied to clipboard

Low contrast boxes on new documentation webpages

Open bronger opened this issue 9 years ago • 6 comments

FWIW, on my screen and seen with my eyes, the boxes on the new documentation pages have a background colour almost as bright as the main background. This way, the contrast is reduced compared to the old pages, making quick skimming more difficult.

For instance, look at the code snippets on https://docs.djangoproject.com/en/1.7/intro/overview/ and the adminition boxes on https://docs.djangoproject.com/en/1.7/intro/install/

bronger avatar Dec 16 '14 19:12 bronger

+1 for this. I also feel that the new document style looks cleaner, but at the same time less overseeable. I also think that more contrast might fix this, e.g. for the boxes.

A similar issue, also with https://docs.djangoproject.com/en/1.7/intro/overview/ as a good example, the HTML code samples have very rich contrast (as there is a lot of bold, green text), while the Python code samples are have very low contrast (as there is almost nothing highlighted, except import/def/class statements), not even the REPL prompt (>>>).

raphaelm avatar Dec 17 '14 11:12 raphaelm

:+1: Very pretty, but the first thing I found when then actually trying to read the docs was a reduction in my ability to skim the text for what I was after because everything is too similar and washed out, e.g. the lines/separation between headings/sections, the code excerpts, the warning at the end of https://docs.djangoproject.com/en/1.7/ref/models/options/#ordering all seem to merge into one when I try to read it now.

dracos avatar Dec 18 '14 15:12 dracos

This issue has been automatically marked as stale because it has not had recent activity. It will be closed if no further activity occurs. Thank you for your contributions.

stale[bot] avatar Oct 07 '22 10:10 stale[bot]

I'm not sure if any style tweaks were made since this issue was created, but it may still be relevant. (stalebot, please don't close.)

timgraham avatar Oct 09 '22 01:10 timgraham

Maybe this issue is superseded by #974 and can be closed ?

pauloxnet avatar Oct 09 '22 10:10 pauloxnet

Maybe this issue is superseded by https://github.com/django/djangoproject.com/issues/974 and can be closed ?

I don't think so, accessibility have been improved in dark mode but light mode have still issues (I tried to keep the light mode has it was) and it's also related to the multiple shade of colors we have. @xi have started a PR which will address parts (entirely?) the issue.

sabderemane avatar Oct 24 '22 16:10 sabderemane