On Wednesday, December 28, 2016 at 12:00:24 AM UTC-6, Matthew Butterick wrote: > Google's policy is coercive and awful. But even if it weren't, the practical > problem is that code samples don't shrink well because they can't be > line-wrapped. [1] > > > [1] https://github.com/racket/scribble/pull/62
I agree about Google and that's a very valid point you bring up there. But, in the spirit of that feedback loop from outside of academia that Matthias Felleisen asked for, couldn't you simply add all three code layout options and then add a commandline switch in scribble when generating html? I.e. by default, do nothing with the code. Otherwise, add switches to either wrap the code or else put it in those nasty horizontally scrolling boxes? But also please keep in mind that this is not just about the Racket docs. It's any Scribble document looking not so hot on mobile by default unless you tinker with the CSS (which no one wants to do). What brought it to my attention was writing a silly program in literate Racket using Scribble to see how it worked in Racket. As you know, with literate programming, you can always break apart those large naughty functions into small chunks, which will in turn give you better mobile friendly looking code. So the point it, it's not just the Racket docs I'm getting at here, but Scribble html in general. In any case, thanks for the lively feedback and quick action! Excellent community here. -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
