I tend to keep things simple. I wrote Implementing CIFS in very plain HTML. Yes, by hand. No, I didn't flail myself with birch bows or kneel on jacks just to prove my inner strength. It was honestly the simplest, easiest way to format everything. Mind you, I had a very supportive publisher.

...and I used to write college papers in Runoff, so I'm used to that kind of markup.

...and I would probably want to learn Docbook if I were to do it all over again.