Hi Blake and David, We were talking about this very node of the documentation yesterday with Ludovic and zimoun, so here are my two cents. Rewriting this introduction is a very good idea, the current one is pretty hard to get into for novices.
David Pirotte <da...@altosw.be> writes: > Not at all - and quite annoying. imo. > So i'd 'vote' not to use them anywhere in the guile reference manual I agree that it's not "idiomatic Guile" so should probably be left out. Regarding the examples, I think the first one is nice but the next one is too involved, using a named let which a lot of users might not know. I'd suggest demonstrating each feature without any extra prerequisite, to make it as accessible as possible. The third example, introducing the ellipsis, uses 2 of them directly, with one nested! It also doesn't explain what the pattern variables are bound to when an ellipsis is involved. Also, the example data you're matching on looks too intimidating, which could scare novice readers. Best, -- Josselin Poiret
