[racket] Best way to propose changes to Scribble CSS files

From: Matthew Butterick (mb at mbtype.com)
Date: Sat Nov 16 11:31:51 EST 2013

It's a reasonable suggestion. I've updated the design so that all the internal cross-references share the same color. 

http://mbutterick.github.io/racket-doc-redo/doc/ 




On Nov 15, 2013, at 7:25 AM, Neil Toronto <neil.toronto at gmail.com> wrote:

> On 11/13/2013 11:33 PM, David T. Pierson wrote:
>> On Wed, Nov 13, 2013 at 06:55:10PM -0800, Matthew Butterick wrote:
>>> I've made a number of updates to the Scribble CSS, and posted more sample
>>> docs, if you care to revisit:
>>> 
>>> http://mbutterick.github.io/racket-doc-redo/doc/
>> 
>> I notice an improvement in the styles used with definitions and most
>> content on pages like
>> 
>> http://mbutterick.github.io/racket-doc-redo/doc/reference/pairs.html
>> 
>> But some of the link styles are still too grey/light for me (like the
>> link for "Mutable Pairs and Lists" at the top of the above page) and the
>> links in the table of contents pages like
>> 
>> http://mbutterick.github.io/racket-doc-redo/doc/guide/index.html
>> 
>> are too light for my eyes.
>> 
>> When I'm reading a web page for information I like the links to stand
>> out.  I suppose it helps me scan/navigate more efficiently.  I feel like
>> the grey links have the opposite effect.  It is as if they are hidden.
> 
> There are studies that show hyperlinks may reduce reading comprehension by increasing cognitive overhead, and that how much is partly determined by how they are presented:
> 
> http://en.wikipedia.org/wiki/Reading_comprehension#Reading_comprehension_and_hyperlinks
> 
> Overhead also seems depends on the background of the reader. Readers with more domain knowledge appear to be less affected by hyperlink presentation.
> 
> What Matthew has come up with might be a decent compromise.
> 
> Neil ⊥
> 
> ____________________
> Racket Users list:
> http://lists.racket-lang.org/users

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.racket-lang.org/users/archive/attachments/20131116/2689175e/attachment-0001.html>

Posted on the users mailing list.