> > Assume readers know the basics or will look them up [...] One of the beautiful things about reading on the internet is that google is just a click away. >

> > Assume readers know the basics or will look them up [...] One of the beautiful things about reading on the internet is that google is just a click away. > Especially in the case of technical jargon, it's a good middle ground to link to a relevant definition directly. That avoids the friction of a suboptimal in-line definition and the friction of forcing a multi-click lookup. A beautiful part of the internet is links :). I remember one personal website that's been linked on HN (https://www.gwern.net/ https://www.gwern.net/) where hovering links show a preview of the page, a bit like wikipedia is doing, but not limited to the top, where it's possible to scroll up and down. I think a similar system could be interesting when dealing with technical subjects.