Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Gerry Weaver
Hi Noob, I'm very new to Racket and the community as well. I happen to agree that the web development docs could use some improvement. However, I'm not sure tweaking the one person that is in the best position to help you is wise. Further, from what I have seen so far, Jay is very objective in

Re: [racket] nested require modules and global variable

2011-12-17 Thread Danny Yoo
On Saturday, December 17, 2011, Niitsuma Hirotaka < hirotaka.niits...@gmail.com> wrote: > Is this valid behavior? > The sub.scm file you posted looks malformed, so some copy-and-paste error probably happened. Otherwise, can you also say what you expected to see? __

[racket] nested require modules and global variable

2011-12-17 Thread Niitsuma Hirotaka
Is this valid behavior? -sub-sub.scm-- #lang racket (provide my-global-var print-my-global-var set-my-global-var!) (define my-global-var "global in sub-sub") (define (print-my-global-var) (display my-global-var) (newline)) (define (set-my-global-var! v) (set! my-global-var v)) ---

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Sam Tobin-Hochstadt
Would it be possible for programmer to provide a name generator, so that you could have pretty urls of the form: foo.com/session/175 You'd have to ensure in the web server that there weren't conflicts with the names currently being managed, but it seems plausible. On Sat, Dec 17, 2011 at 3:12 PM

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Jay McCarthy
But, if you would like to have more traditional URLs in addition to the continuation/cryptic ones, you can use the web-server/dispatch library: http://docs.racket-lang.org/web-server/dispatch.html It starts with a bit of guide to orient you before the reference manual. It allows you to create UR

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Shriram Krishnamurthi
Hi R. Noob, > Do the URLs of pages that use continuation > mechanism have to look ugly and cryptic? Yes they do. The URLs are ugly *because* they are cryptic. They are cryptic because it is a route to system security. If they were pretty, people could guess them, and that would adversely affec

[racket] Racket documentation for web development is just awful!

2011-12-17 Thread Racket Noob
Hey Niel, I'm not your enemy (just annoys me that do not understand anything), but poor documentation surely is. Regarding this "big and complicated thing": the Windows API, for example, is ugly and complicated. Yet, legendary Charles Petzold managed to write a very readable and clear book

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Hendrik Boom
Let me react just to what's being said here, though I am not familiar with any of the documents mentioned. I've found that what's often missing in documentation written by programmers is that it's too nose-to-the-ground. Once you understand what's going on, it's excellent in telling you the de

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Neil Van Dyke
Racket Noob wrote at 12/17/2011 11:05 AM: and, if we look at the number of web applications written in Racket today, they can be counted on the fingers of one hand. There's at least a few more than that. Some Racket developers are secretive. Regarding the topic of your message, consider tha

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Racket Noob
I've already read. Continue tutorial is not bad, I passed through it (congratulations, Danny Yoo, you're man!) But now when I want to make the next step and further understand the web development in Racket, unfortunately I am forced to read Jay's documentation. I am very sad about it. : (Unfo

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Sam Tobin-Hochstadt
First, I want to encourage you to take a look at the "Continue" tutorial: http://docs.racket-lang.org/continue/ . It provides an excellent introduction for people new to the Racket web server. Second, one of the great things about Jay is that in addition to the video game talent and popped collars

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Matthias Felleisen
Dear Racket Noon, thank you for outspoken criticism. There is no question that all of our documentation and writing could be improved so that a lot more people can understand the basics. So here is a proposal: write it with the help of list members here. Yes, there's a significant gap betw

Re: [racket] Racket documentation for web development is just awful!

2011-12-17 Thread Robby Findler
Please, if you have constructive criticism, it would be welcome. But messages like this are not helpful. Robby 2011/12/17 Racket Noob : > > Dear Racketeers, > > I think I am a man of average intelligence. I have read, for example, HtDP > and SICP without any major problems. Nevertheless, even wit

[racket] Racket documentation for web development is just awful!

2011-12-17 Thread Racket Noob
Dear Racketeers, I think I am a man of average intelligence. I have read, for example, HtDP and SICP without any major problems. Nevertheless, even with the best will, I do not understand the documentation called "Web Applications in Racket", written by Jay McCarthy (http://docs.racket-lang

Re: [racket] Can I start with Ch 1 to 7 of htdp 2e

2011-12-17 Thread Matthias Felleisen
On Dec 16, 2011, at 9:29 PM, Rajiv Abraham wrote: > Hi, > I have been waiting to start playing with htdp 2e . Thanks for posting it > online ! > > - Can I start with Ch 1 to 7 assuming that they are stable enough without > major revisions? Yes. > - Does anyone know the tentative schedule f