Re: [racket-users] Guide and reference

2019-02-08 Thread Alex Harsanyi
On Friday, February 8, 2019 at 5:16:31 PM UTC+8, Jens Axel Søgaard wrote: > > > Den ons. 6. feb. 2019 kl. 12.33 skrev James Geddes >: > >> 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

Re: [racket-users] Guide and reference

2019-02-08 Thread Jens Axel Søgaard
Den ons. 6. feb. 2019 kl. 12.33 skrev James Geddes : > 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. T

Re: [racket-users] Guide and reference

2019-02-08 Thread Jos Koot
+1 On Thu, 7 Feb 2019 at 18:48, David Storrs 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, g

Re: [racket-users] Guide and reference

2019-02-07 Thread David Storrs
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 R

Re: [racket-users] Guide and reference

2019-02-06 Thread Hendrik Boom
On Wed, Feb 06, 2019 at 06:33:11PM -0500, Neil Van Dyke wrote: > I think RnRS came across as "too academic", like "Holy crud!  A > function return is a call!  OMG, we're all, like, cosmically connected, > man...  And a return is... a first class object?!  WTH!"  And the formal > semantics -- which

Re: [racket-users] Guide and reference

2019-02-06 Thread Neil Van Dyke
James Geddes wrote on 2/6/19 6:33 AM: 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 mostly like RnRS.  For one practitioner reason, you can hand many programmers the canonical

[racket-users] Guide and reference

2019-02-06 Thread James Geddes
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 th