Jeff Epler's blog

2 May 2006, 23:08 UTC

Whine!!!!!!!&exclam;

Having recently tried to write some documentation, I'm a bit struck by how much all the alternatives I'm aware of suck. All I want is to get a nice HTML and PDF output of a document with a few tables. Some signs pointed towards this thing called "openjade", which is a "document style semantics and specification language" (I guess).

Imagine how unimpressed was when I got a look at the documentation they had produced—If anybody is going to have good-looking documentation it should be the people making the "document style" software! At first I thought of blaming myself because I had a wide screen, but it's even bad on a maximized window on a 1024x768 monitor, with its black text over a terrible dithered dark blue background.

I guess I'll go back to writing HTML by hand and using "File > Print" to produce PDF. Or maybe I'll write LaTeX again and berate people who don't seem to know how to use xpdf.

[permalink]