Paul Tarvydas re open.substack.com/pub/programmingsimplicity/p/on-programming-using-non-gutenberg, you might like this attempt of mine at introducing a graphical overview to a program:
akkartik.name/2025-03-02-chessboard
The drawback: I'm not trying to turn the diagrams into executable code. They're just documentation, but at a level that's not onerous to keep updated, then falling back on raw/eldritch textual code for the heavy lifting.
Ivan Reese's 💬 #linking-together@2025-03-03 also feels relevant. Every hyperlink is a counterfactual, every webpage is a choose-your-own-adventure story.
The way I'm imagining it it's just a little markup language of drawing commands. git.sr.ht/~akkartik/luaML.love but with some support for a "link target" that the view switches to when you click on a rectangular area.
Basically making image maps in html is quite tedious. This is image maps but well-integrated with a vector- rather than pixel-drawing system.
Another way to think of it: this is GToolkit's customizable inspectors, if every inspector is like a little html webpage. You string together a choose your own adventure out of them.
