From: Tom Cloyd <tomcloyd@...>
Date: 2009-07-04T07:55:36+09:00
Subject: Re: RDoc 2.3 now with Darkfish, without CHM and extra HTML t

Roger Pack wrote:
> Eric Hodel wrote:
>   
>> This release of RDoc brings some big changes. Most notably Michael
>> Granger�s Darkfish generator has become the default output format for
>> RDoc! Michael put a ton of great work into this, and it looks quite
>> lovely. Check out the RDoc documentation for a sample:
>>     
>
> I like darkfish.  Thought I'd pipe in a couple suggestions.
>
> 1) the method names include a prefix '#'
> which makes single letter method names hard to read
>
> 2) the font is low contrast so harder to read.
>
> Just talking out loud.
> =r
>   
I totally concur about the low contrast fonts. Accessibility gurus say 
DON'T DO THIS.

People with aging eyes - like me - find these fonts significantly harder 
to read. People with genuine vision impairments find them simply 
impossible, often.

Iron rule: if you put something on a website which people are expected 
to read, make it black font against a light background. Large fonts can 
be reverse-color - IF distinctly large AND well contrasted with a dark 
back ground. This is a basic design aspect of webpages (or CSS sheets) 
which MUST be attended to if usability matters to anyone at all.

t.

-- 

~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Tom Cloyd, MS MA, LMHC - Private practice Psychotherapist
Bellingham, Washington, U.S.A: (360) 920-1226
<< tc@tomcloyd.com >> (email)
<< TomCloyd.com >> (website) 
<< sleightmind.wordpress.com >> (mental health weblog)
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~