My wishlist for exec. books:
– author did their "real thinking" in the authoring computational environment
– reading environment invites + supports meaningful experimentation/exploration
– book elements transparently and usefully reusable by author and readers in derivative works
Conversation
Imagine if creating a derivative work was as easy as importing one notebook from another, or even importing it into normal non-notebook code... ;)
1
I didn't realize the latter was supported from RunKit—very cool! Are you aware of any serious "executable books" published using RunKit?
1
Depends what “serious” means — the goal is precisely to bring notebook style development to normal programming:
1. Tons of bugs filed using RunKit notebooks (no more “works on my computer”, always reproducible forever since packages frozen in time):
1
2. A huge amount of “notebooks” embedded in docs all over the web using RunKit embeds — interactive programming “as a service”. Why ask users to imagine code behavior when they can run it on a real Linux server in the docs:
expressjs.com/en/starter/hel
Docs: runkit.com/docs/embed
2
Right! These seem like super valuable use cases, and they're the ones I think about when I think about RunKit. I was wondering whether anyone's used it as an environment for interactive expository text, as described in
1
Ah, I thought from original tweet you meant the “switching” to real impls by “serious”. Most expository text ends up using embeds interestingly enough (plenty of dev.to use RunKit for their examples fir example). vs. hosting *on* RunKit.
1
1
This is something I’m pretty interested in: the fact that the former model is “host on service” (and don’t own the post on your machine), or host yourself (and probably lose interactivity since it’s just a “rendering”). (Cont.)
1
1
I think embeds strike a good balance, where if like RunKit ever goes away, the example “degrades” to static code. But otherwise the document is “live.” So you can control everything except for the “running”, including the actual code (in your source control right in the post)
1
3
Yes, I see the tension there. Maybe ideally you'd like to be able to "bake" the book as a bunch of static stuff you can host yourself.
2
2
(But I see how that breaks a bunch of RunKit's node environment magic)