[Top][All Lists]

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: RFC: Adding syntax highlighting to the official documentation

From: Jean Abou Samra
Subject: Re: RFC: Adding syntax highlighting to the official documentation
Date: Sat, 18 Dec 2021 18:38:42 +0100
User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.3.1

Hi John,

Le 18/12/2021 à 17:31, a écrit :
When employing color in printed text, or print requivalent text, please be considerated of your readers who are color blind or have attention problems related to color.

For the former you need to provide a way to completely remove color from the material without making it un-readable.  For example, in the colorized code shared earlier, and depending on visual imparment, words that are in color could be completely missing for some readers.

For, the later group, a way to opt out of colorization should be considered a requirement. I have seen text books that I personaly cannot read because some who owned the book before had taken a hilighter to.

I am not sure I understand the issues at
hand well. I thought it would suffice to
design the color scheme with high enough
contrast so that the code would stay readable
for people with impaired vision. I have
been using the WCAG contrast indicator for
that. It's true that the first proposed
style had bad contrast (I didn't realize
the problem at that time), but the new one
has a minimum of 6.1 which I thought would
be enough above the AA level of 4.5. Do
you think it is necessary to provide a way
to opt out of syntax highlighting nevertheless?
By printed text, do you mean the PDF output,
or also HTML output? (I thought there would
be tools to remove color when browsing?)
Could you say more about 'attention problems
related to colors'? I don't know much about
this topic, but I am curious to learn more.


reply via email to

[Prev in Thread] Current Thread [Next in Thread]