[racket] Best way to propose changes to Scribble CSS files
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!