Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Make it easier to find destructuring info? #713

Open
mars0i opened this issue Jan 3, 2025 · 0 comments
Open

Make it easier to find destructuring info? #713

mars0i opened this issue Jan 3, 2025 · 0 comments

Comments

@mars0i
Copy link

mars0i commented Jan 3, 2025

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. Since this has happened to me numerous times, I've started to wonder whether it would be a good idea to make it easier to find this information.

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. Of course the Guide on destructuring is less terse and does more hand-holding than the Reference section on binding, as you'd expect, but 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's a reasonable keyword. In my case, I look for "pattern matching", but when I see "destructuring" I know that that's what I'm looking for. Maybe someone coming from another language wouldn't know that? Not sure. In any event, it would be helpful if someone could use that term to find information about destructuring.

Thanks!

@mars0i mars0i changed the title Make it easier to find destructuring info Make it easier to find destructuring info? Jan 3, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant