[racket] Teach Yourself Racket (version 0.1)

Hi Prabhakar,

Really excellent material.  Thanks for doing this.

Here are some suggestions after a first read-through:

Intro: "languages" should be "language"
1.7: the last paragraph would be nicely illustrated with a short example
(list of lists, maybe?)
2.1: some explanation of the "alternative" list functions would be nice
2.2: The wording, "to compute a list of arguments to such a function."
might be better as "to pass a list of arguments to such a function."
2.2 and 2.4: The end of these sections should give a better idea of where
in the Racket docs to look
3.2: Add an example of why and where box, unbox, etc are useful
3.2: "converstion" is misspelled
3.2: The last paragraph seems like it should be a topic of its own.

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?

-Joe




On Fri, Aug 31, 2012 at 6:53 PM, Prabhakar Ragde <plragde at uwaterloo.ca>wrote:

> 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.
>
> https://cs.uwaterloo.ca/~**plragde/tyr/<https://cs.uwaterloo.ca/~plragde/tyr/>
>
> Followups by private e-mail to me, please, unless they're really relevant
> to the community at large. Thanks. --PR
> ____________________
>  Racket Users list:
>  http://lists.racket-lang.org/**users <http://lists.racket-lang.org/users>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.racket-lang.org/users/archive/attachments/20120902/5cec07f0/attachment-0001.html>