Hi, I think we successfully ruled out xdoc :)
Other than that I'm not sure how to proceed. Maybe we should postpone the decision a bit and put new documentation on the wiki for now. The wiki is probably better suited for getting our docs off the ground anyway. Does the wiki require separate accounts/privileges? I can't seem to log in with my usual Apache credentials. Regards, Matthias On Wednesday, 2012-07-11, Matthias Friedrich wrote: > Hi, > > I set up the new Maven site using Markdown because we already had one > document in Markdown syntax. I think before we add more documentation > we should decide for a Doxia module [1] before it's too late :) > > With Doxia we have the following alternatives: > > XDoc is the old Maven 1 format that is still used by many Apache > projects. It uses XML which makes it a bit unpleasant to use, > especially for code examples. > > APT is the main Maven 2 format. We use it extensively at work, but > it's the worst plain-text markup language I've ever used. You can get > used to it though and it works. > > Markdown is pretty popular on Github. It has its weird corners and > the Doxia module seems pretty young. The error messages it generates > weren't very helpful to me and breadcrumbs are broken (do we need > them?). > > Confluence/Textile has the advantage that you *might* be able to copy > and paste stuff from the wiki to the Maven site. I don't know how > well the module works. > > So, which one do you want to use? > > Regards, > Matthias > > [1] http://maven.apache.org/doxia/modules/index.html
