zig.guide
zig.guide copied to clipboard
Unreadable due to colors
This tutorial is unreadable because of the poor color contrast. The first line of the first example:
const std = @import("std");
I can only read the =
sign if I use very big fonts since the contrast between red and black is so low.
I know that black is very fashionable as a background but it is useless for reading.
On a side note the instructions for setting the path in Windows don't mention using Control Panel; they should at least mention that possibility since not everyone uses powershell.
I don't mean this offense, or as an attack in anyway. But are you color blind?
The =
sign is not red but pink for example. The background is not black but grey.
For me it all looks fine. Or maybe you tallk about an older version.
I am not color blind. The colors look red and black to me. But anyway that is really beside the point: what matters is that the contrast is so poor that the tutorial is unreadable.
Are the colors on the image the same as on the website for you?
Yes black background. I agree that what I thought was red is some kind of
dark pink. However the =
and ==
are so blurred that they look like -
and --
; it is only the context which makes it clear to me that they are
='s. Also I'm guessing that 1 *
has a * and similarly 3 *
. So it seems
that for some reason the dark pink is especially hard for me to read.
On Mon, 28 Dec 2020 at 10:28, Doeke Wartena [email protected] wrote:
Are the colors on the image the same as on the website for you? [image: poor_colors] https://user-images.githubusercontent.com/738650/103207894-bb3b0600-48ff-11eb-8260-c8bb17850153.png
— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/Sobeston/ziglearn/issues/56#issuecomment-751665213, or unsubscribe https://github.com/notifications/unsubscribe-auth/AANQ6JH2ZTADOEU5HAK6XLLSXBMVJANCNFSM4S6GPY6A .
-- Mark Summerfield, Qtrac Ltd., www.qtrac.eu
Can it be that you have a monitor with really bad contrast?
No, since the same effect happens on my big-screen desktop and the laptop I'm replying on.
On Mon, 28 Dec 2020 at 10:35, Doeke Wartena [email protected] wrote:
Can it be that you have a monitor with really bad contrast?
— You are receiving this because you authored the thread. Reply to this email directly, view it on GitHub https://github.com/Sobeston/ziglearn/issues/56#issuecomment-751667086, or unsubscribe https://github.com/notifications/unsubscribe-auth/AANQ6JG2LTHY2XZBI6XRWI3SXBNNZANCNFSM4S6GPY6A .
-- Mark Summerfield, Qtrac Ltd., www.qtrac.eu
I'm working on some front-end upgrades at the moment. Everything should be available in both light and dark mode soon-ish (respecting your OS/browser preferences). I just need to figure out how to get different syntax highlighting working on the light theme and all is good.
For the mean time, you should be able to view the content clearly from the github repo itself - github renders all the markdown well as far as I can tell.
Closed in https://github.com/Sobeston/ziglearn/pull/197