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

From: Matthew Flatt (mflatt at cs.utah.edu)
Date: Sat Nov 9 09:35:30 EST 2013

At Sat, 9 Nov 2013 02:12:55 -0500, Matthew Butterick wrote:
> The prototype repo is here:
> 
> https://github.com/mbutterick/racket-doc-redo/tree/gh-pages
> 
> To preview the pages in a web browser, start here:
> 
> http://mbutterick.github.io/racket-doc-redo/doc/index.html

That looks fantastic.


At Sat, 9 Nov 2013 07:44:58 -0600, Robby Findler wrote:
> Also, the margin comment in the "Set..." section here
> http://mbutterick.github.io/racket-doc-redo/doc/quick/index.html seems to
> have moved into the middle of the page.

I see that effect when I make my browser window narrow enough, but then
the note moves back to the right margin when I make my window wider ---
which may address Neil's issue with the right-margin notes. Nice.


I'm not sure about the shift to boldface for bound names in code. I
think there's value in keeping a consistent style and coloring for code
across DrRacket (in default mode), the documentation, slides, etc.
Boldface identifiers can look good in the documentation, but in other
contexts, font-weight changes have not worked so well; we previously
moved away from bold for syntactic-form names for that reason. My
preference would be to change the style less at that level.

As a nit, given the overall gray look, the yellow background for a
`require`/`#lang` library box looks somehow mismatched or too prominent
to me.


Thanks very much for your work!


Posted on the users mailing list.