Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Backtick & comma introduced w/o explanation #12

Open
lojic opened this issue Aug 8, 2014 · 1 comment
Open

Backtick & comma introduced w/o explanation #12

lojic opened this issue Aug 8, 2014 · 1 comment
Assignees

Comments

@lojic
Copy link
Sponsor

lojic commented Aug 8, 2014

In section 3.4, you introduce ` and , in the our-if-v2 macro. I know about the interplay of ` and , from fooling around with Common Lisp a bit, but that was the first I've seen them used in Racket (still very new), and some people may not understand their use at that point in your tutorial.

@greghendershott
Copy link
Owner

Thanks for the feedback! Writing stuff like this is hard, because you have to decide how much your readers already know. Assume they know too little, and it gets tedious and boring. Assume they know too much, and they won't understand.

Your comment gets to the fact that I assume readers know roughly as much about Racket as I did, when I was recording my struggles to learn about macros.

Although that's probably true for many readers, it wasn't for you. I'm not sure I can solve that in general (see the "tedious" point, above). But I could try to address this specific thing. :)

I'll take a stab at that. If explaining quasiquoting becomes too long a digression, however, I might have to just link to someone else's explanation. Hopefully that would still help.

Thanks again for your comment!

@greghendershott greghendershott self-assigned this Aug 9, 2014
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants