<html> <head> <style></style></head> <body class='hmmessage'><div dir='ltr'> <br> Hey Niel, I'm not your enemy (just annoys me that do not understand anything), but poor documentation surely is.<br> <br>Regarding this "big and complicated thing": the Windows API, for example, is ugly and complicated. Yet, legendary Charles Petzold managed to write a very readable and clear book about it. (Oh, if only we could convince Petzold to write a nice book about web development in a Racket! :))<br> <br>Of course, I cannot write better documentation because i don't have a clue, but I hope that I can at least express my opinion that this current is not good. And i think this is one of the main reasons for poor use of Racket in the web (otherwise, Racket is just great!).<br> <br><BR><div><div dir="ltr"><div><div id="ecxSkyDrivePlaceholder"></div><hr id="ecxstopSpelling">Date: Sat, 17 Dec 2011 12:06:54 -0500<br>From: neil@neilvandyke.org<br>To: racketnoob@hotmail.com<br>Subject: Re: [racket] Racket documentation for web development is just awful!<br><br> Racket Noob wrote at 12/17/2011 11:05 AM: <blockquote cite="mid:COL105-W34D50453942CC93D66CF45C9A10@phx.gbl"> <style> .ExternalClass .ecxhmmessage P {padding:0px;} .ExternalClass body.ecxhmmessage {font-size:10pt;font-family:Tahoma;} </style> <div dir="ltr">and, if we look at the number of web applications written in Racket today, they can be counted on the fingers of one hand.</div> </blockquote> <br> There's at least a few more than that.  Some Racket developers are secretive.<br> <br> Regarding the topic of your message, consider that you are reading the *reference manual* for something that is big and complicated.  As you know, the first priority of a reference manual is to capture technical information, not to gently instruct in usage, nor to be fun to read.  Perhaps, as Matthias suggested, you would write one of the usage documents, based on what you're learning and on your prior experience?<br> <br> <div class="ecxmoz-signature">-- <br> <a class="ecxmoz-txt-link-freetext" href="http://www.neilvandyke.org/" target="_blank">http://www.neilvandyke.org/</a> </div></div> </div></div> </div></body> </html>