+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 > --------------------------------------------------------- > > > > > > > >
