django / djangoproject.com

Source code to djangoproject.com
https://www.djangoproject.com/
BSD 3-Clause "New" or "Revised" License
1.87k stars 942 forks source link

Low contrast boxes on new documentation webpages #198

Open bronger opened 9 years ago

bronger commented 9 years ago

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/

raphaelm commented 9 years ago

+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 (>>>).

dracos commented 9 years ago

:+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.

stale[bot] commented 1 year ago

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.

timgraham commented 1 year ago

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.)

pauloxnet commented 1 year ago

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

sabderemane commented 1 year ago

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.

kjaymiller commented 2 days ago

Maybe this issue is superseded by #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.

I noticed today that when you highlight code blocks (in my case to show another developer a potential solution). The vibrant green completely washes out the muted colors and it is incredibly hard to read in dark mode . (Happy to create a separate issue on this)

washed out code block that is highlighted by the cursor