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

2013-11-09 Thread Matthew Butterick
On Sat, Nov 9, 2013 at 8:44 AM, Robby Findler wrote: > > A technical question: in the docs for contract-out ( > http://mbutterick.github.io/racket-doc-redo/doc/reference/attaching-contracts-to-values.html), > I see that the code oversteps its box in the new version, but not the old. > Is that so

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

2013-11-09 Thread Matthew Butterick
Thank you for the comments so far. As for the gentleman who was "reluctant to say anthing negative," please don't be — the point of making a prototype is to find out what doesn't work. I won't cover every suggestion here on the mailing list because it will become unwieldy. But I'll move the tricki

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

2013-11-09 Thread Greg Hendershott
This is so wonderful and I'm so happy you did this. It is awesomely awesome. Truly. Thank you, thank you, thank you! My only gripe so far is the floating search box that insists on being in the top-left corner and won't scroll away. On a desktop browser, some people find that sort of thing mildl

Re: [racket] Boston Area Meet Up

2013-11-09 Thread Greg Hendershott
On Sat, Nov 9, 2013 at 4:28 PM, Daniel King wrote: > How does first or second week of December work for you? I like Wednesdays, > personally. Either week is fine for me. I also think Wednesdays are good generally. > No one else has showed interest, but perhaps if we set a date we can get some >

Re: [racket] Boston Area Meet Up

2013-11-09 Thread Daniel King
On Fri, Nov 8, 2013 at 11:01 AM, Greg Hendershott wrote: > Just FYI, not saying it's better, the handful of meetups I've been to > so far all used a format like: I like the broken down format. I also feel a lot more comfortable signing up for a ten minute talk than a half hour one. How does firs

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

2013-11-09 Thread Asumu Takikawa
On 2013-11-09 14:50:33 -0500, Eli Barzilay wrote: > * Possibly some result of your copying: the toplevel page has two > "Racket Documentation" links, one to the itself, and one to itself > with a URL fragment that goes to the title. I think this is just a Scribble bug that Matthew fixed a few

Re: [racket] Forcing termination of a for loop

2013-11-09 Thread Daniel Prager
> > (I noticed that the code ran under Racket v5.3.4. but under > Racket v5.2.1. none of the code ran - it showed > for: bad sequence binding clause at: #:break?) The #:break clause isn't available in the for form of v5.2.1: http://download.racket-lang.org/docs/5.2.1/html/reference/for.html?q=fo

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

2013-11-09 Thread Eli Barzilay
[In no particular order:] * Like other people, most of the changes are very nice. * The floating navigation thing is cute, but I agree with Matthias that the search box can be left on the top since it's usually not useful when reading through the text -- that would leave the navigation arro

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

2013-11-09 Thread David T. Pierson
On Sat, Nov 09, 2013 at 02:22:30PM -0500, David T. Pierson wrote: > The light gray (?) background of definitions is so light that it doesn't > show up for me if I'm not looking at it straight on. That is partially > an indictment of my laptop's screen, but I don't have that problem with > with the

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

2013-11-09 Thread David T. Pierson
On Sat, Nov 09, 2013 at 02:12:55AM -0500, Matthew Butterick wrote: > To preview the pages in a web browser, start here: > > http://mbutterick.github.io/racket-doc-redo/doc/index.html Matthew, I imagine a significant amount of work was put into this, which I appreciate, and which makes me relucta

[racket] Forcing termination of a for loop

2013-11-09 Thread Robert Wilkinson
Hello I am learning to program in racket - and have questions regarding forcing the exit from a for loop. I wrote the following program to determine the largest prime factor of a number. (The correct answer being 11 in the case of input 165)

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

2013-11-09 Thread Robby Findler
On Sat, Nov 9, 2013 at 11:13 AM, Neil Toronto wrote: > On 11/09/2013 07:35 AM, Matthew Flatt wrote: > >> 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 i

[racket] dynamically auto-initialized private struct fields

2013-11-09 Thread David T. Pierson
Hi all, Sometimes when defining struct types it is useful to have fields which are essentially "private" to the module (fields whose accessors/mutators are not exported from the module.) I want these fields to be initialized automatically with arbitrary values generated at construction time. Here

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

2013-11-09 Thread Neil Toronto
On 11/09/2013 07:35 AM, Matthew Flatt wrote: 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/i

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

2013-11-09 Thread Matthias Felleisen
Lovin' it. I am writing the draft of HtDP/2e in Scribble: http://www.ccs.neu.edu/home/matthias/HtDP2e/index.html and I have had several requests for the content menu to slide along in the left margin. I think it would be okay if searching remained at the top, and the content menu were slid

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

2013-11-09 Thread Robby Findler
On Sat, Nov 9, 2013 at 8:35 AM, Matthew Flatt wrote: > 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://mbutteri

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

2013-11-09 Thread Asumu Takikawa
On 2013-11-09 02:12:55 -0500, Matthew Butterick wrote: >The prototype repo is here: >[1]https://github.com/mbutterick/racket-doc-redo/tree/gh-pages >To preview the pages in a web browser, start here: >[2]http://mbutterick.github.io/racket-doc-redo/doc/index.html This looks really g

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

2013-11-09 Thread Laurent
It's quite nice, especially the automatic resizing. On a Samsung Note 2, it works well in Firefox and Chrome, but not on the default browser (unless I check "Adapt pages sizes", but this an enforcement of the browser, and some quirks still remain). It may be an issue of the browser itself though.

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

2013-11-09 Thread Sam Tobin-Hochstadt
First, this is great! I tried it on my Nexus 7 tablet, and it worked very well. Second, a very minor bug: on Chrome on the Nexus 7 (but not on Chrome on my desktop, or on Firefox on the tablet), the grey search box when you scroll down doesn't quite go down far enough -- the "p" in "up" extends b

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

2013-11-09 Thread Matthew Flatt
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.

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

2013-11-09 Thread Neil Van Dyke
When rethinking Racket documentation CSS&JS, please consider supporting narrower browser windows by making the left and right margins optional. Autohide the TOC, and make the footnotes either inline or autohidden. Regarding downloadable fonts, I suggest making Scribble default to generic font

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

2013-11-09 Thread Robby Findler
I like it! Making the window smaller and see the font shrink is especially amazing. A technical question: in the docs for contract-out ( http://mbutterick.github.io/racket-doc-redo/doc/reference/attaching-contracts-to-values.html), I see that the code oversteps its box in the new version, but not