On Friday, August 24, 2018 at 9:33:12 PM UTC-4, Robby Findler wrote: > The racket documentation is organized into two documents. > … > Guide: http://docs.racket-lang.org/guide/define-struct.html > > Reference: http://docs.racket-lang.org/reference/define-struct.html
I noticed the separate User's Guide and Reference, and indeed that's one reason I'm considering Racket for practical use right now. This two-document structure used to be commonplace in software. I think it's a really good, effective approach and I'm glad to see it in use again. I'm asking for something much smaller than a User's Guide, though: a little collection of the down-and-dirty stuff that you need to know to be productive, beyond knowing the syntax and semantics of the language. Often this kind of information goes undocumented and is learned only by word of mouth. Sometimes it's documented in tutorials, but I haven't found a tutorial for this yet. The DrRacket documentation may well already have it; I haven't read much of that yet. A really narrow "Welcome to Racket" tutorial specifically for people coming over from Clojure would be the most efficient thing for me to read, but I realize that this may be asking more than is feasible. However, I am willing to help write one in collaboration with someone who already knows their way around Racket. The best time to write such a thing is while beginning—when the stuff that goes without saying because everyone knows it is still getting said. Ben -- 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.
