add Fears of Macros to the references

[capfredf]

I think @greghendershott's guide on macros is awesome.

[greghendershott]

Thanks for saying so. However to the extent the bee is about syntax-PARSE, FoM isn't so awesome. It mainly says go read the docs.

Probably a better PR or issue would be one filed against FoM -- to make sure I have a link from FoM to additional resources like the syntax-parse example repo! :smile:

[greghendershott]

Oh, I just realized I already added such a link a few years ago.

[bennn]

Right --- the announcement doesn't talk about Fear of Macros because it doesn't talk about syntax parse.

I would be happy including a note along those lines, though. The Syntax Parse Examples docs say this:

The Fear of Macros tutorial is also very good, but was written before the age of syntax parse.

and we could include that, or something similar.

[greghendershott]

This might be nit-picky, but:

The Fear of Macros tutorial is also very good, but was written before the age of syntax parse.

Actually the whole last section of Fear of Macros "builds a case" for why something like syntax-parse is good.

I just didn't go further into it because, as I wrote:

November 1, 2012: So here’s the deal. After writing everything up to this point, I sat down to re-read the documentation for syntax-parse. It was...very understandable. I didn’t feel confused.

Why? The documentation has a nice Introduction with many simple examples, followed by an Examples section illustrating many real-world scenarios.

Update: Furthermore, Ben Greenman has created a package whose docs provide an excellent set of even more Syntax Parse Examples.

Regardless I 100% agree FoM isn't a resource for learning about how to use syntax-parse. :smile:

[bennn]

The nitpick is welcome. What to say instead?

The Fear of Macros tutorial is a great resource for basic macro engineering (though, not syntax-parse in particular).

[greghendershott]

That would be wonderful. Thanks!