Hi Prabhakar,<div><br></div><div>Really excellent material. Thanks for doing this.</div><div><br></div><div>Here are some suggestions after a first read-through:</div><div><br></div><div>Intro: "languages" should be "language"</div>
<div>1.7: the last paragraph would be nicely illustrated with a short example (list of lists, maybe?)</div><div>2.1: some explanation of the "alternative" list functions would be nice</div><div>2.2: The wording, "<span style="font-size:medium;font-family:serif">to compute a list of arguments to such a function.</span>" might be better as "to pass a list of arguments to such a function."</div>
<div>2.2 and 2.4: The end of these sections should give a better idea of where in the Racket docs to look</div><div>3.2: Add an example of why and where box, unbox, etc are useful</div><div>3.2: "converstion" is misspelled</div>
<div>3.2: The last paragraph seems like it should be a topic of its own.</div><div><br></div><div>Again, thanks, a general comment I would add is that I used and learned from the direct link you had to the PLT blog, adding more direct links to the Racket docs will make your doc even more usable. Keywords and functions are already highlighted, maybe you can make them links as well?</div>
<div><br></div><div>-Joe</div><div><br></div><div><br></div><div><br></div><div><br><div class="gmail_quote">On Fri, Aug 31, 2012 at 6:53 PM, Prabhakar Ragde <span dir="ltr"><<a href="mailto:plragde@uwaterloo.ca" target="_blank">plragde@uwaterloo.ca</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">I've been meaning for some time to write something called Teach Yourself Racket, and finally scraped an alpha version together under threat of classes starting (I'm going to use it in my grad course). I'd appreciate comments to help me improve it.<br>
<br>
<a href="https://cs.uwaterloo.ca/~plragde/tyr/" target="_blank">https://cs.uwaterloo.ca/~<u></u>plragde/tyr/</a><br>
<br>
Followups by private e-mail to me, please, unless they're really relevant to the community at large. Thanks. --PR<br>
____________________<br>
Racket Users list:<br>
<a href="http://lists.racket-lang.org/users" target="_blank">http://lists.racket-lang.org/<u></u>users</a><br>
</blockquote></div><br></div>