Sorry, I don’t agree here. Most of the time it is completely irrelevant whether def is a keyword or a macro. I don’t need to know. Yes, you need to describe the alternative ways of writing a def, if, etc but at this stage it is really not necessary to explain why, a reference to a place where it is described is enough. And seriously while macros are cool and a lot of fun most users will not be defining their own macros, and those that do will need to read a section describing macros anyway.
And again the syntax reference section while it is correct is definitely not needed at this level. Worst case it can scare people off. Someone comes looking for a description of def and starts to wonder whether:
- Do I really need to know all stuff just to define a function?
- Does this mean I can write the expanded AST forms instead? (this is my thought anyway
)
