How do you want it read and what's the audience? Assuming it's technical material for an HN type audience, realize that no one's going to sit and read through i

How do you want it read and what's the audience? Assuming it's technical material for an HN type audience, realize that no one's going to sit and read through it at once, so you need to think about making digestible chunks and having good navigation. I like the GNU Make manual a lot and it's absurdly low tech. git-scm.com is much more modern looking but has essentially the same structure. For tablets PDFs can work really well. If you want to be read straight through or be an offline reference (printed or tablet) that might be better but not if you're going for random access. Man pages are a nice model too. Edit: typo I'll attribute to autocorrect