Ben Kovitz wrote on 08/24/2018 10:04 PM:
I noticed the separate User's Guide and Reference, and indeed that's one reason I'm considering Racket for practical use right now.
The separation of a Guide is good for a read-through, like on the train, when first exposed to a system. *But*, for day-to-day looking up things while actively using Racket, I often/usually end up needing both Guide and Reference, and the separation is actually a big burden. And, if I'm following links among multiple things within the manual, to find/learn what I need, there are two additional problems: at each point, there's a good chance I'm missing relevant information/explanation about that thing, which is in the other manual (but I don't want to keep checking at every step); and, as I'm navigating around, I might miss something entirely because the navigation got me into the Guide, and it just didn't cover that thing.
Now that Racket has a number of tutorial manuals (and even more tutorials can be created independently), there's less need for a Guide to be the train read for people new to it, at the cost of the Guide+Reference separation burdening those same people while they're actually using it, for every day after.
-- 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.
