Another project shot me down this past week. John Lazzaro of the sfront project wasn't interested in using DocBook. He wanted to keep his reference manual's horrendous HTML layout.
This layout is horrible (http:// www.cs.berkeley.edu/~lazzaro/sa/sfman/), it uses multiple tables with two separate running columns. The tables break in strange places. Sometimes the columns are only tenuously related to each other. It doesn't make any sense. Attempting to read it gives me a headache.
At least he keeps it up-to-date, uses FDL, and provides a way to look at it off-line. IMHO, that puts him light-years ahead of most Open Source projects as far as documentation goes.
