Hi all, I think it is perhaps worth reconsidering how we generate our documentation. I think it would be good to have an approach that supported the following:
1) storing the documentation "source" in svn, with the code. That means it can be versioned and diffed easily 2) ability to generate at high quality HTML and PDF versions of the documentation The Hibernate and Spring projects use docbook as a format and IMO their documentation is excellent. One other option I have heard mentioned is Forrest (http://forrest.apache.org) but I don't have any experience of that. Can anyone share any opinions of it? RG
