I'm not sure how active the HaskellDoc mailing list is just now,
but there's a terrific flurry of mail about CamlDoc on the Caml
mailing list. It must be worth looking carefully at their design.
Simon
http://caml.inria.fr/archives/200110/threads.html