On Wednesday, October 26, 2011 3:15:16 PM, "Jesse McConnell" <[email protected]> wrote: > Just a friendly note that in jetty we have started to look at > abandoning using the wiki in favor of a docbook approach to produce > documentation. Also it looks like the apache directory folks are > going a similar route of producing their wiki documentation through > docbook as well. Much of the maven documentation has trended the same > way, at least that produced by Sonatype. If your starting from > scratch it may be worth taking a few minutes to investigate other > options. There are also other options like markdown and some tooling > that lets you go from wiki text files into docbook and then be > transformed into xhtml, pdf, eclipse-help, and many other options all > in a maven build.
We are already using markdown for our main web site, although it isn't being built with maven. We could attempt to use the main site in place of a wiki once CMS is enabled for it. The downside is that only committers would be able to edit it. It would be nice if others could contribute as well. Billie
