well, we are putting our docbook project out on github for collaboration, that way we can take in pull requests...but I digress, wiki's need a lot of care and feeding or they become a morass of goop. good luck! :)
cheers, jesse -- jesse mcconnell [email protected] On Wed, Oct 26, 2011 at 15:00, Billie J Rinaldi <[email protected]> wrote: > 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 >
