[ moved to dev ] This looks really great! Playing around with the CSS a little, I think that it would be better if the words were all lowercase (delete "text-transform: capitalize;" from plt/doc/racket.css to try it out).
Robby On Sat, Jun 16, 2012 at 8:21 PM, Matthew Flatt <mfl...@cs.utah.edu> wrote: > I've pushed this change to the git repo. > > At Tue, 12 Jun 2012 22:02:26 -0400, Neil Van Dyke wrote: >> With Scribble-formatted API documentation, one thing I kinda miss from >> Lisp-y manuals (such as those formatted by Texinfo, or CLtL2) is a >> better cue that something is documenting, say, a procedure, rather than >> syntax, rather than a parameter. >> >> One way to do this with Scribble would be to subtly add a label to the >> light blue background for definition syntax synopses. For example >> (click the second thumbnail): http://imgur.com/a/xFTFn >> >> Of course, with this particular format, the definition could obscure >> this label, so unless you wanted to make the label a really big font >> that was intended to be obscured (which doesn't really fit the look of >> the manuals), it would complicate formatting. >> >> Or you could put the label in the right margin, where footnotes go, but >> I'd actually like to get rid of the right margin as a necessary thing >> later, and turning footnotes into hover slide-outs when there isn't >> enough horizontal room, so I'm not fond of putting anything new in the >> margins that we'd want visible as cues. >> >> Comments? >> >> Neil V. >> >> ____________________ >> Racket Users list: >> http://lists.racket-lang.org/users > ____________________ > Racket Users list: > http://lists.racket-lang.org/users _________________________ Racket Developers list: http://lists.racket-lang.org/dev