Re: RFC: Adding syntax highlighting to the official documentation

[Jean Abou Samra]

Hi John,

Le 18/12/2021 à 17:31, wheelerwjx9@runbox.com 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.

Thanks,
Jean