I’ve had some trouble with Markdown as it seems the version supported by Maven 
is limited. I’m happy to switch to something that works better. That said, I am 
perfectly comfortable writing xdoc as well.

Ralph

> On Apr 6, 2018, at 9:29 AM, Matt Sicker <boa...@gmail.com> wrote:
> 
> I've been using AsciiDoc for the Scala site, and I know others here have
> used it as well. I was thinking it would be nice to standardize on it.
> There is an asciidoctor plugin for maven-site-plugin, so we can use it with
> our existing layout for now as well for Log4j.
> 
> One major advantage for us is that you can easily include source file
> snippets via macros. This would make our documentation more easily
> maintainable as it wouldn't get out of sync. There could be some other
> documentation generators explored later for Log4j plugins and such which
> would be pretty neat, too. Another advantage is that asciidoc has its own
> macros and such which are more useful than velocity.
> 
> What do you think? If there aren't any objections, I'll supersede my
> earlier markdown efforts with asciidoc instead.
> 
> -- 
> Matt Sicker <boa...@gmail.com>


Reply via email to