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

From: Racket Noob (racketnoob at hotmail.com)
Date: Sat Dec 17 11:37:32 EST 2011

 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: samth at ccs.neu.edu
> Date: Sat, 17 Dec 2011 11:18:06 -0500
> Subject: Re: [racket] Racket documentation for web development is just awful!
> To: racketnoob at hotmail.com
> CC: users at 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 <racketnoob at 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
> samth at ccs.neu.edu
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.racket-lang.org/users/archive/attachments/20111217/c56f3ee6/attachment.html>

Posted on the users mailing list.