Sneak Peek! Nutshell, or, “Expandable Explanations”
Added 2021-08-24 11:00:04 +0000 UTC[Patreon's still paused; you won't be charged until further notice]

Howdy! I prototyped this a year ago, but then I went on burnout-hiatus. But last week, I re-designed & polished it up so that you can get a sneak peek:
🥜 Nutshell! (or, “Expandable Explanations”) 🥜
👷(work in progress, sneak peek) 👷
Why I've wanted this tool for so long: I like sharing what I've learned, but sometimes I'm learning stuff that's not beginner-level, but I want my writing to stay accessible to all levels. Re-explaining the basics each time would be a pain (and boring to those who already know it), but "go click this link to catch up on X" would break the flow of reading (and waste time, if you only need to know some of X, not all of it).
Hence: expandable explanations! Don't know a thing? Click it, and you'll learn just-in-time, not just-in-case. (Don't know a thing inside that thing? Keep on expanding that explanation!)
The best part? It works across pages, websites, and authors. The bestest part? Blog posts from the past already work with Nutshell! (it just scrapes sites for sections of text to embed) This way, any explanations anyone writes in the future – or have already written in the past – can be cross-embedded like a big ol' potluck dinner.
It's not ready for public use yet, but for now, you can play with writing your own articles with Nutshells: (demo linked above)

Finally, a personal point – this is all part of Possible Plan #2 For What To Do Once I Come Back From Burnout-Hiatus. (Plan #1 is the queer/furry lewd Patreon. Which is still going! Thank you to the 30+ pervs who've signed up so far.)
Plan #2 is "just become a blogger". Well, a blog with Nutshell's expandable explanations, some interactive diagrams, and hopefully Spaced Repetition with Andy Matuschak's Orbit. But other than that, I become just a good ol' fashioned blogger.
(And there's so many mini-explanations I'd love to blog about, with high re-use value via Nutshell. High school algebra! Causal inference! Systems biology! Etc.)
The two big reasons for my burnout were 1) not being with people I care about, and 2) the work no longer being fun. Becoming "a blogger" would let me work way, way less (freeing up time for people & hobbies), and each blog post can be a low-cost exploration into a new thing.
I've had that plan years ago, but my biggest turn-off was that it'd feel like "one damn thing after another", each blog post another disposable disconnected distraction on the internet. But hopefully, with Nutshell, each blog post's explanations can be re-used not just by future me, but by everyone.
(Well, it's either that or the furry lewds. Or both.)
Anyway, play around with Nutshell, try writing something in it, and let me know HONESTLY what you think so far, and what you'd personally want to use it for!
Deez Nuts,
~ Nicky Case
Comments
This is absolutely brillant!
Pierre Thierry
2021-09-25 10:03:46 +0000 UTCThis is absolutely incredible! I've been trying it out, and it's fantastic for writing technical documentation for developers. I'd love to use & test this when it's in beta
David Allison
2021-09-05 16:38:07 +0000 UTCYou might find this project interesting https://peblproject.org/index.html < it's an open source spec for interactive ebooks. I think they are trying to figure out some similar things :)
Juukii
2021-08-31 16:02:05 +0000 UTCThe recursive interlinking reminds me of the Fighting Game Glossary: https://glossary.infil.net I just love ways of organizing ideas. Looking forward to Nutshell.
Benoit Doidic
2021-08-27 23:37:35 +0000 UTCHahaha! ya. right. just read on. i guess the fact, that this has not occurred to me might say "something" about my brain :D
Chris K
2021-08-26 19:48:49 +0000 UTCGotcha. Tumblr allows.... something, but I'm no coder; still, if it gets implemented for real, I'm confident someone will test it there! Thanks!
yves.
2021-08-26 17:18:18 +0000 UTCThanks for this feedback & these suggestions, Chris! I especially like the idea of "zipping it up"; even though one *could* just keep scrolling past the bubble to read on, the neat-freak in me also wants to clean it up when done.
Nicky Case
2021-08-26 15:16:36 +0000 UTCIt'll work even without Markdown! Unfortunately -- and this does limit it -- it won't work on blogs where you can't add your own JavaScript. So, no for Patreon & Medium & Substack. I *think* Tumblr may still allow adding s? I know Wordpress & Ghost does.
Nicky Case
2021-08-26 15:14:36 +0000 UTCThanks for that bug report, Eric! I have... no idea why that would happen. Cross-browser debugging is the worst.
Nicky Case
2021-08-26 15:12:40 +0000 UTCI wonder how it would work on a full-scale website, like wikipedia. do you have an example for us next time? Also I wonder if it made sense to have a button at the bottom of the rabbit hole to zip it all back up and go back to reading the main article. currently, i cannot middle-click the nuts to open them into a separate tab for later reading. I think i would like that. cheers!
Chris K
2021-08-26 09:39:04 +0000 UTCI played around and really enjoyed it. Definitely would use this in my blog articles as I also tend to write about moderately complicated subjects for a broad audience of mixed experience. Integrating simple explanations into the flow of a long text has definitely been a pain point.
Dave Pickett
2021-08-25 18:04:06 +0000 UTCHonestly this is amazing. I don't know what else to say besides that. Great job. :)
Snake Dog
2021-08-25 17:05:49 +0000 UTCTIL Patreon comments support inline HTML.
Eric Willisson
2021-08-25 13:47:38 +0000 UTCI am so excited by this. I have had something like it in mind for years! (I wish I'd ever produced anything to show I was thinking about it, but I think I always got overwhelmed by the UI.) It seems like you cracked it! The only weird thing is that on the demo page (but not the instructions page), on Chrome for Android, when I tap a Nutshell link, the rest of the text in that section gets much bigger, like it's all <h1> text. The Nutshell link stays the same size.
Eric Willisson
2021-08-25 13:46:20 +0000 UTCI love this, and I'm curious how it'd work for people who aren't used to Markdown. When you say blogs, does it work on Patreon and Tumblr? Thanks for the innovation!!
yves.
2021-08-25 00:18:03 +0000 UTCThank you! Will PM you when a beta-version is ready for testing :)
Nicky Case
2021-08-24 21:08:23 +0000 UTCShoot, link fixed! (If site still doesn't look updated, try this link directly: https://ncase.me/nutshell-wip/try/ )
Nicky Case
2021-08-24 20:59:48 +0000 UTCYup, Telescopic Text was one of the big inspirations! (The other one was some blog that, when it linked to other pages on its blog, let you preview the other page on hover. I think Wikipedia does that now, too, but it's not recursive)
Nicky Case
2021-08-24 20:59:21 +0000 UTCShoot! Alright, I pushed up a fix. (If the site is still showing the old link, due to caching, here's the link directly: https://ncase.me/nutshell-wip/try/ )
Nicky Case
2021-08-24 20:57:12 +0000 UTCAh shoot! You're right, that's the correct link! I pushed up the fix, thanks for catching that.
Nicky Case
2021-08-24 20:56:49 +0000 UTCWow!! Love the UX behind expandables!! Great work, Nicky!! - Cass
Work on Climate
2021-08-24 19:12:18 +0000 UTCLove this! Can't wait to try it out! (when that broken link gets fixed)
Christine Capra
2021-08-24 17:11:05 +0000 UTCThis is an amazing concept, I can't wait to see how it develops!
Aeryn Light
2021-08-24 16:04:37 +0000 UTCWould actually love to see this :)
Lynn
2021-08-24 12:56:20 +0000 UTCI like the idea of Nutshell and had an idea for you. Take it or not. You could create a way for readers to select text/topics they'd like to learn more about and those could become a backlog of topics to write about. Making the selected text/topics visible to other readers would allow your audience to crowdsource voting for the most valuable things to dive into. Just a "Yes and" for your consideration. Hope the hiatus is going well.
Joshua T Kalis
2021-08-24 12:50:39 +0000 UTCI like this. It would make many things easier
Danny Hansen
2021-08-24 12:48:13 +0000 UTCThis reminded me of a tool I saw a while back named Telescopic Text. It is similar to Nutshell, and you can try it out through a web-based editor. Here is a sample short story about drinking tea: https://www.telescopictext.org/text/KPx0nlXlKTciC
Benoit Doidic
2021-08-24 12:03:20 +0000 UTC"Try Nutshell" link no work
marko
2021-08-24 11:53:05 +0000 UTCThis is really cool! There's a broken link though, I think - the "Let's Try Nutshell!" link goes to [https://ncase.me/try], which leads to a 404. I think that link should be [https://ncase.me/nutshell-wip/try/], right?
Robin Roschlau
2021-08-24 11:29:21 +0000 UTComg I would absolutely love to use Netshell for my own site! If you need beta testers I’d be happy to help 🙂
Adrian Kant
2021-08-24 11:04:38 +0000 UTC