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

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




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 		 	   		  
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.racket-lang.org/users/archive/attachments/20111217/4f37d670/attachment.html>

Posted on the users mailing list.