I tried to do a nice job with http://jsxgraph.Mentat.org and the others in that series

Or http://leva.Mentat.org

Using an interactive clerk notebook felt like a nice way into a complicated library

http://inside-out.matt.is/ this is a nice example for a forms library imo

I am looking at Clerk now and also MathBox.cljs they seem like fun places to start. I would just "Get Started" with a topic you are interested in.

I really like the format, but for my thing in particular clerk likely is not the way (lots of non clojure code)

but this is helpful for sure

I think whats hard for me is 1. Tooling selection (tempted to just use clerk as a markdown renderer) but also 2. My target audience is almost zero experience folks, so I have to undo a lot of assumptions

Old but gold - https://github.com/clj-commons/seesaw This tutorial: https://gist.github.com/daveray/1441520

I think the slides for that were the best reference when I was messing with it

same issue with targetting a more advanced audience / being clojure specific

but the prose is useful

Audience is key for sure. are you looking for examples of projects that build up a how to assuming nothing?

Like, here’s what the terminal is, here’s how to install Java etc?

Not that low..

for context, I'm trying to document the library I wrote here https://clojurians.slack.com/archives/C1AC4BU2K/p1668137423838269

the primary use is to be something easier to teach

than Jackson databind specifically

so my audience is people who want to use json and have whatever minimal context they have when they want to do that

so they would already have some sort of editor set up, but might not have an intuitive sense for every mechanic

Zach Tellman's "manifold" (https://aleph.io/) and Re-Frame are both notable for their attention to orienting the newcomer (and their completely different styles).

I think you can provide an interactive notebook for java nowadays

lmk if you remember how - that would be useful for a different thing

Seems like it Just Works TM https://stackoverflow.com/questions/40917409/using-jupyter-notebook-for-java