Tools are already there, just read from one format and write to another using Doxia.
I'm definitely not going to do it manually. On Oct 5, 2013, at 1:28 PM, Kristian Rosenvold <kristian.rosenv...@gmail.com> wrote: > If we were to deprecate one or more documentation formats, wouldn't it > make sense to make a plugin to automate the conversion ? After all, > there's a few thousand sites out there that might want such a > modernization ? > > Kristian > > > 2013/10/5 Tamás Cservenák <t.cserve...@gmail.com>: >> +10 for markdown and getting rid of old formats. Markdown is really easy, >> and as Jason says, tooling for editing it is really superb. >> >> Thanks, >> ~t~ (mobile) >> On Oct 5, 2013 5:19 PM, "Jason van Zyl" <ja...@tesla.io> wrote: >> >>> We current have multiple formats for our site documentation and two of >>> them no one else in the world uses except us. We created xdoc here a long >>> time ago in the Jakarta project, and APT has lost in the world of markup. I >>> ported it from another project many years ago but there are many better >>> options like asciidoc, restructured text, and markdown. My preference is >>> for markdown but I would like to get rid of xdoc, fml, and xdoc and convert >>> that documentation over to markdown. The tool support is great for editing, >>> book support is great (the Pro Git book is created from markdown). We can >>> still use all the Doxia tools for all the post processing. But I see no >>> need to 4 different types of markup for the site, and honestly I find >>> working with APT now incredibly annoying. >>> >>> I'm happy to do the conversion and testing. >>> >>> Thanks, >>> >>> Jason >>> >>> ---------------------------------------------------------- >>> Jason van Zyl >>> Founder, Apache Maven >>> http://twitter.com/jvanzyl >>> --------------------------------------------------------- >>> >>> >>> >>> >>> >>> >>> >>> > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@maven.apache.org > For additional commands, e-mail: dev-h...@maven.apache.org > Thanks, Jason ---------------------------------------------------------- Jason van Zyl Founder, Apache Maven http://twitter.com/jvanzyl ---------------------------------------------------------
