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
