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

From: Robby Findler (robby at eecs.northwestern.edu)
Date: Sat Dec 17 11:11:29 EST 2011

Please, if you have constructive criticism, it would be welcome. But
messages like this are not helpful.


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

Posted on the users mailing list.