Dear All, There was a recent discussion on this list about the Racket guides and manuals. Without wishing to comment on the suggestions therein, I did want to say what I really, really like about the Racket documentation.
There are two things. The first is that the Reference is — and I know this sounds odd — true: when I want to know something, I look it up in the Reference, and there I find the truth and the whole truth about the thing. I don’t know how this is made to happen, but I find it extraordinarily helpful. It’s not an intuitive explanation, or an analogy, or a description in vague language: it’s the truth. (And it’s organised very well so I know where to look.) The second thing I like is the concision of the Guide. It is readable, and may well contain intuitive explanations and ways to think about things, yet it does so with economy. There are of course things I am still confused about (packages…) but in general I’ve not found elsewhere this tasteful combination of clarity and completeness. (Well, except RnRS, so maybe my prejudices are showing through.) I find other languages point me to books about the language that take too long to get a handle on the basics; and exhaustive references that seem to contain both more than I want and less than I need. Thank you to everyone who has worked on the documentation. James James Geddes -- You received this message because you are subscribed to the Google Groups "Racket Users" group. To unsubscribe from this group and stop receiving emails from it, send an email to racket-users+unsubscr...@googlegroups.com. For more options, visit https://groups.google.com/d/optout.
