+1 On Thu, 7 Feb 2019 at 18:48, David Storrs <david.sto...@gmail.com> wrote:
> For what it's worth, I like having the Guide and the Reference be > separate things. They have different purposes and trying to mash them > together is likely to make them worse at both. > > The Guide is designed to introduce new concepts, give the reader basic > familiarity, and clarify edge cases. > > The Reference is intended to be, well, a *reference*. It is concise > and exhaustive. It requires a certain degree of familiarity to > provide full value but once you have that familiarity it becomes > invaluable. Perhaps there are places where a few more examples > wouldn't hurt, but folding pages of soft-walk introduction into each > section would be a waste. Either it's at the top and gets ignored > when you're trying to look something up or it's inline and gets in the > way. > > -- 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.
