Does the Guide need to mention syntax parse & does the Style guide need to provide guidance?

[Stephen De Gabrielle]

Hi

With reference to this discussion on reddit/r/racket :

https://www.reddit.com/r/Racket/comments/ie8rlf/when_creating_macros_is_syntaxparse_preferred_to/?utm_source=share&utm_medium=ios_app&utm_name=iossmf 

Does https://github.com/racket/racket/blob/master/pkgs/racket-doc/scribblings/guide/macros.scrbl need to be updated to link to the syntax parse introduction https://docs.racket-lang.org/syntax/stxparse-intro.html ?

What should it say? 

> Robust macros can be written with syntax-parse and syntax classes.

Does the Style Guide need a section for when to use syntax-rules, -case or -parse?

 

What should it look like?

(in the spirt of https://docs.racket-lang.org/style/Choosing_the_Right_Construct.html#%28part._.Functions_vs_.Macros%29) 

Kind regards

Stephen 

--

----

[Sorawee Porncharoenwase]

The guide seems to be for the Racket code base (https://github.com/racket) rather than general Racket code, so I don't think it should say "prefer syntax-parse over syntax-case". 

I do think there should be a style guide for general Racket code (which could very well be based on the style guide for the Racket code base), and for this guide, it would make sense to say "prefer syntax-parse over syntax-case".

--
You received this message because you are subscribed to the Google Groups "Racket Developers" group.
To unsubscribe from this group and stop receiving emails from it, send an email to racket-dev+...@googlegroups.com.
To view this discussion on the web visit https://groups.google.com/d/msgid/racket-dev/CAGHj7-J6XdT%3DzGtt5aVA8M6ZgJX2%3D0G-6ZnR%2BUYRBTQsLczKnw%40mail.gmail.com.