Matt Sicker commented on LOG4J2-1802:

Good point. Thankfully, AsciiDoc supports PDF output as well, so if the maven 
site output doesn't work properly anymore, I can convert it to use AsciiDoc's 
native PDF support.

> Convert documentation into AsciiDoc
> -----------------------------------
>                 Key: LOG4J2-1802
>                 URL: https://issues.apache.org/jira/browse/LOG4J2-1802
>             Project: Log4j 2
>          Issue Type: Documentation
>          Components: Documentation
>            Reporter: Matt Sicker
>            Assignee: Matt Sicker
>            Priority: Major
> The xdoc system currently in place is difficult to use correctly (it expects 
> proper XHTML, no block level elements inside inline level elements, the usual 
> pedantry from an XHTML/XML validator) and is needlessly verbose for writing 
> documentation.
> After experimenting with Markdown as an alternative to xdoc, it has not been 
> powerful enough for our uses. AsciiDoc, however, does offer more features 
> useful here without extending the markdown processor itself. This will also 
> help unify documentation formats used in other Log4j projects.

This message was sent by Atlassian JIRA

Reply via email to