clojure / clojure-site

clojure.org site
https://clojure.org
Eclipse Public License 1.0
249 stars 271 forks source link

Official docs (rationale and guide) on datafy / nav #553

Open raymcdermott opened 3 years ago

raymcdermott commented 3 years ago

This ticket is to follow up on the plans for documentation that Alex confirmed in response to this Question on Ask Clojure

https://ask.clojure.org/index.php/11032/are-there-plans-for-official-docs-rationale-and-guide-datafy

vemv commented 6 months ago

Bump 🙂

A topic suggestion - Is it correct to say that datafy can be presumed to be side-effect-free but nav not?

In the CIDER Inspector, our existing behavior (which I believe incorrect), is that for rendering [x y z], we call nav on each of x, y, z. So we can inadvertently perform side-effects if the user specified that nav should go over http, or jdbc, etc.