Grinnz / perldoc-browser

Perldoc Browser
https://perldoc.perl.org
Artistic License 2.0
55 stars 21 forks source link

Please increase text contrast! (aid stopping the madness of low contrast) #58

Closed hadjiprocopis closed 1 year ago

hadjiprocopis commented 1 year ago

Personally, I find the contrast between normal text (see e.g. https://perldoc.perl.org/perlform, color #445555) and the background (color #fff) too low for a doc-browser in which the user must be assisted in concentrating on the content and not squint to read it.

Lack of contrast is so disturbing for me that often I resort to reading the doc from man-pages via my terminal. Albeit not as practical, at least I don't squint and wrinkle this way.

I believe that increasing the contrast of Perl doc browser will not decrease a user's ability to read Perl documentation neither will degrade the user experience. On the contrary, the former will be vastly improved and the latter well ... hmmm ... please, just make a quick opinion poll and see for yourselfs. I have done one at Perlmonks.org and got 100% agreement (4/4, including me).

Personally, a black (#000000) text on the already white background will allow me to open the curtains and get some sunlight. And from what little HTML I know, it is a matter of changing text color #445555 to #000000. And once at it, why not change contents color which is currently #2a2a2a and code blocks color which is currently #2f3337. All to black.

Please bring some light to our programmer's life with adding more black color!

OT: I do not understand which marketing guru the "low contrast" madness came from but, AFAIC, it has spread like the plague, it makes my browser-reading a misery (github where this issue is edited has also this low-contrast policy) and proves that after some time, design improvements kill the product.

Many thanks for the Perl doc browser which is very helpful otherwise,

5min edit: P.s. I understand that the HTML theme/CSS of the Perldoc browser may have been taken from somewhere and therefore it may not be a design choice of the creators of the Perldoc browser.

bw bliako

Tux commented 1 year ago

I agree. Related: please stop making dark-theme default without having a decent light-theme available in way too many applications. To people like me it makes me not even want to delve into features, as all the fun has gone before even starting. De gustibus non est disputandum.

Grinnz commented 1 year ago

I agree. Related: please stop making dark-theme default without having a decent light-theme available in way too many applications. To people like me it makes me not even want to delve into features, as all the fun has gone before even starting. De gustibus non est disputandum.

I'm not sure the relevance as #33 has not even been implemented yet 😄

Grinnz commented 1 year ago

I've applied a darker font color in https://github.com/Grinnz/perldoc-browser/commit/76dd3b14dcffb243baeeec4221b57dbd0476a712. The code block coloring is applied by highlight.js and not our stylesheet. Thanks for the feedback!

hadjiprocopis commented 1 year ago

THANK YOU

On 17/05/2023 09:01, Dan Book wrote:

I've applied a darker font color in 76dd3b1 https://github.com/Grinnz/perldoc-browser/commit/76dd3b14dcffb243baeeec4221b57dbd0476a712. The code block coloring is applied by highlight.js and not our stylesheet. Thanks for the feedback!

— Reply to this email directly, view it on GitHub https://github.com/Grinnz/perldoc-browser/issues/58#issuecomment-1550786087, or unsubscribe https://github.com/notifications/unsubscribe-auth/AB5PLOQ4UWSO2I6ZQGIUXZ3XGRSUHANCNFSM6AAAAAAX7MDJLQ. You are receiving this because you authored the thread.Message ID: @.***>