Make it easier to find destructuring info
I love Clojure, but I go through long periods where I don't use it at all. As a result, I repeatedly need a refresher on the nuances of destructuring. Every time I do this, I go to clojure.org and spend at least five minutes poking around and trying to find the page that goes into different ways of using keywords in maps, how to use `&`, etc.
First, it's difficult to find info about destructuring in the Reference section of clojure.org. It's there under "Binding Forms" (although I didn't find it before I started writing this), but there's no way to figure this out from the top level. There's a page on destructuring in the Guide section, which is great, but since defining functions and using `let` is basic, core information, I'm going to look to Reference for that first. I don't expect to need a guide for a refresher on core functionality.
Second, in other languages, similar functionality is sometimes called "pattern matching", so when I'm coming back to Clojure after a while away, sometimes *that's* the keyword I'm looking for. That's not the term we use in Clojure, and I don't think it appears on clojure.org, but it would be helpful if someone could use that term to find information about destructuring.
Thanks!
0 条评论