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. : (Unfortunately, in this case I find it difficult to give any constructive criticism, I do not know even where to start. Maybe a question for the end: Do the URLs of pages that use continuation mechanism have to look ugly and cryptic? Can this somehow be avoided (so that we have pretty URLs, but still have a continuation?) Racket Noob > From: sa...@ccs.neu.edu > Date: Sat, 17 Dec 2011 11:18:06 -0500 > Subject: Re: [racket] Racket documentation for web development is just awful! > To: racketn...@hotmail.com > CC: users@racket-lang.org > > 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, he's very responsive to > suggestions. If you have specific things that could be explained > better, I'm sure he'd be happy to hear about them. > > Finally, while we all appreciate feedback, personally insulting people > isn't appropriate in this context. > > 2011/12/17 Racket Noob <racketn...@hotmail.com>: > > > > 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.org/web-server/index.html). > > > > I think that I'm not the only one who does not understand (and, if we look > > at the number of web applications written in Racket today, they can be > > counted on the fingers of one hand. It is a shame because Racket is a great > > programming language, but with poorly written and unclear documentation like > > this, Racket will hardly ever become popular in the web world!). > > > > Let's face it: Jay McCarthy is perhaps an excellent programmer and all his > > honor. But, as a documentation writer, this man has no idea. > > This is my well-intentioned advice to this community: let someone with more > > literary talent to write documentation for web development in the Racket! > > > > Racket Noob > > > > _________________________________________________ > > For list-related administrative tasks: > > http://lists.racket-lang.org/listinfo/users > > > > -- > sam th > sa...@ccs.neu.edu
_________________________________________________ For list-related administrative tasks: http://lists.racket-lang.org/listinfo/users
