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







Reply via email to