<html> <head> <style></style></head> <body class='hmmessage'><div dir='ltr'> <br> I've already read. Continue tutorial is not bad, I passed through it (congratulations, Danny Yoo, you're man!)<br><BR><div><div dir="ltr"><div><div>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. : (</div><div>Unfortunately, in this case I find it difficult to give any constructive criticism, I do not know even where to start.</div><div> </div><div>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?)</div><div> </div><div> </div><div>Racket Noob</div><div> </div><div> </div>> From: samth@ccs.neu.edu<br>> Date: Sat, 17 Dec 2011 11:18:06 -0500<br>> Subject: Re: [racket] Racket documentation for web development is just awful!<br>> To: racketnoob@hotmail.com<br>> CC: users@racket-lang.org<br>> <br>> First, I want to encourage you to take a look at the "Continue"<br>> tutorial: http://docs.racket-lang.org/continue/ . It provides an<br>> excellent introduction for people new to the Racket web server.<br>> <br>> Second, one of the great things about Jay is that in addition to the<br>> video game talent and popped collars, he's very responsive to<br>> suggestions. If you have specific things that could be explained<br>> better, I'm sure he'd be happy to hear about them.<br>> <br>> Finally, while we all appreciate feedback, personally insulting people<br>> isn't appropriate in this context.<br>> <br>> 2011/12/17 Racket Noob <racketnoob@hotmail.com>:<br>> ><br>> > Dear Racketeers,<br>> ><br>> > I think I am a man of average intelligence. I have read, for example, HtDP<br>> > and SICP without any major problems. Nevertheless, even with the best will,<br>> > I do not understand the documentation called "Web Applications in Racket",<br>> > written by Jay McCarthy (http://docs.racket-lang.org/web-server/index.html).<br>> ><br>> > I think that I'm not the only one who does not understand (and, if we look<br>> > at the number of web applications written in Racket today, they can be<br>> > counted on the fingers of one hand. It is a shame because Racket is a great<br>> > programming language, but with poorly written and unclear documentation like<br>> > this, Racket will hardly ever become popular in the web world!).<br>> ><br>> > Let's face it: Jay McCarthy is perhaps an excellent programmer and all his<br>> > honor. But, as a documentation writer, this man has no idea.<br>> > This is my well-intentioned advice to this community: let someone with more<br>> > literary talent to write documentation for web development in the Racket!<br>> ><br>> > Racket Noob<br>> ><br>> > _________________________________________________<br>> >  For list-related administrative tasks:<br>> >  http://lists.racket-lang.org/listinfo/users<br>> <br>> <br>> <br>> -- <br>> sam th<br>> samth@ccs.neu.edu<br></div> </div></div> </div></body> </html>