Hacker News new | ask | show | jobs
by StavrosK 3747 days ago
Yep, exactly. The idea is that you'd write the sentences being part of the text (as you would normally), and then just hide them behind an expounder link. You just need to take some minimal care for the next sentence to make sense, but other than that, it produces great results. For example, I like the effect it has on the "NodeMCU" link in the article, which you can click if you're unfamiliar with it and you'll get a fitting explanation.

Another section I like is the "rather optional", which explains the rationale for people who may not be aware of it. An author should not fall into the trap of hiding information that's not strictly relevant to the link, though, because then they trap the user into a "okay I need to expand all the links because who knows where the author has hidden useful information" mentality, which kills its usefulness.