improve-getting-started

Vincent 2025-03-20T15:27:55.913619Z

Hi, I posted this in ask clojure today, I am curious about what y'all think about adding analogies / metaphors to the getting started docs. I was very confused by closures until today https://ask.clojure.org/index.php/14472/metaphors-analogies-functional-closures-clojure-docs-please

daveliepmann 2025-03-20T18:08:36.573409Z

I'm not sure metaphors are the best tool here. Different explanations work for different people, though. The Clojure docs don't often spend much time on concepts (like closures) that aren't specific to Clojure. On the other hand, that means that general-purpose programming resources can explain them: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Closures

Vincent 2025-03-21T00:35:46.609659Z

I guess I expect some sort of explanation because of the homonym status (Clojure/Closure)