On Dec 17, 2005, at 1:38 PM, Matt Raible wrote:
Spring and Hibernate use DocBook. I agree that having a text-based
format for documentation is important. I've had great success with
JSPWiki and documentation for AppFuse - but that's only because so
many people have participated. The tutorials alone (50 pages printed)
have been translated to 5 languages! I don't think this type of
cooperation could've happened with documentation stored in Subversion
- but I could be wrong.
Since we've got the wiki locked down, folks can't edit the user guide
anyway. But when they get the user guide in Open Office format in the
distribution, they can easily edit and translate and submit back to us.
And JSPWiki doesn't produce nice paginated docs for printing
And we've been having all sorts of problems managing image attachements
in JSPWiki
- Dave