Docs for destructuring?

[ghost]

I'd add it myself, but I dunno where it would fit.

Looking at the doc indexes, I do not see an obvious place for it.

(Searching for "destructuring" in the docs yielded no results)

[refi64]

Do you mean argument destructuring (like (defn f [[a b]] (+ a b))) or value destructuring (like (setv [a b] c))?

[ghost]

Function, I guess that is argument destructuring.

[berkerpeksag]

Perhaps we can add a new "Hy Cookbook" chapter to docs.

[gilch]

Maybe a cookbook is not a bad idea once we finish the Grand Language Cleanup, but before that it's premature, since we'd have to update it with every change. This will be hard enough as it is. I don't think we've updated anything in eg/ for a while.

A cookbook is not a substitute for a basic reference. It's too hard to find more basic things like "how destructuring works" if the recipes are things like "how to use Hy with Django".

Hy depends a lot on Python's documentation. It would be a waste of time to reproduce the documentation for Python's standard library, for example. But perhaps we could make more explicit references to Python's documentation where appropriate.

[Kodiologist]

This feature was removed in #1590.