Rodent of Unusual Size wrote: > Working documentation for Apache Geronimo should be kept in
[X] Confluence [ ] MoinMoin wiki [ ] Other (explain) I haven't written any Geronimo documentation yet, but if I eventually do, I'd prefer Confluence, primarily because of how easy it makes it to organize, move and rename pages. That's really important in documentation efforts (to optimize the reader experience) and yet is a major pain to do in MoinMoin. Also nice: * Breadcrumbs (linked to easily managed content hierarchy) * Easy to use callout boxes and multi-column layouts within the wiki markup * WYSIWIG editor option which can make it easier to maintain large tables whose rows don't fit on one line in the wiki markup. * Easy to do things like list all of the children of a page along with excerpts, include the contents of another page, pull in RSS feeds, include a sidebar with a list of open JIRA issues, etc. * PDF export of single pages or subsets of the whole content tree * Easy security config if needed (vs. MoinMoin's somewhat awkward ACLs) * I think Maven can parse Confluence content to pull into the generated site (haven't tried this yet) In my experience, the major downside to Confluence vs. MoinMoin (besides infrastructure requirements) is the speed of the edit screen. MoinMoin's edit is almost instantaneous. Confluence's takes a few seconds to render. Overall, that's kind of a pain, but it's not serious enough to outweigh the other Confluence benefits. One major downside of Confluence vs. other wikis like MediaWiki is the inability to edit individual sections of a page. However, MoinMoin doesn't let you do that either, and you can approximate it in Confluence by breaking content out into separate pages and using includes to construct the larger views. Cheers, Erin
