Man, I'm getting Bret Victor vibes! 😁

I really like how you're treating references.

That looks great

Oh, man, now I want to be part of the academy ahahahha it’s great!!!! You really rock, folks

My expectation was that calls to tap> would result in one or both of those calls to clerk/show! updating in place with what was tapped.

Is there a video of using this, so I can understand what it's supposed to do?

It's intended to be used in REPL not in Notebook itself.

user> (require '[nextjournal.clerk :as clerk])
nil
user> (clerk/show! 'nextjournal.clerk.tap)

Ok, but when I evaluate a tap> in the REPL, I see a note about the containing notebook being re-evaluated but I don't see a change to my page.

this renders a page:

(tap> "12314345") produces:

Thanks. Now I'm seeing it.

I'm trying to see how this would be most useful. I had envisioned this fitting into a page, so I could see the results of my calculations, but also side-effect taps during those calculcations.

It's just a tap consumer which renders values on html page. You may render adhoc hiccup, vega chart.

Ok, thanks. When I get a chance, I'd like to contribute some documentation about this.

Also let me plug https://github.com/hlship/trace which goes pretty well with this.

If you work on a notebook, tap inspector is not useful (as you have your results already). But when you work on the library, any code you may want something that pretty prints any values, especially that which require rendering.

(other than normal clojure printing)