Suggestion: Separate syntax cheat sheet

[arrdem]

While the Clojure Cheatsheet has reader literal information, it could be worthwhile to have separate writeups of the macro syntax and of the reader literal syntax both of which have some intricacies.

[robert-stuttaford]

Perhaps @kouphax, author of http://yobriefca.se/blog/2014/05/19/the-weird-and-wonderful-characters-of-clojure/ would be willing to let Grimoire host a reference?

[arrdem]

I'm pondering whether or not this falls in Grimoire's perview as being a quickreference tool. The piece you linked, while awesome, is definitely better suited to its long form than to anything which will appear on Grimoire's frontpage.

I note that the cheatsheet already has macros & reader literals.

I also note that the macro section of the cheathsheet doesn't link to the related symbols. This is arguably a cheatsheet bug. @jafingerhut will likely be getting a PR on this from me.

I'd suggest that the best way to do this is to expect that some future version of the cheatsheet will feature this syntax reference mapping, and to simply add appropriate macro expansion examples to the macro implementation fns which already have Grimoire pages.

[arrdem]

Another interesting/weird point is that if you search for "#()" or "#{}", although they are textually present in the cheat sheet the search bar won't find them.

[arrdem]

Other special characters such as ~, @, ~@, and ` exhibit the same behavior.

[arrdem]

Closing as being too out of keeping with the direction of both the cheat sheet and augmented per-symbol documentation.