the hsqldb guys did a splendid job with their documentation they maintain it in docbook so they have a manual on-line, can generate pdf and a zillion other formats from it today's technologies (i.e. wiki's) are gone tomorrow, docbook is prepared for the future, write an xslt and you are ready - nilo my 0,02euri
Been there, done that (more than 2 years ago). Doesn't work in team, at least not in ours. And personally, I find docbook quite horrible to work with compared to a WIKI. Eelco
