[
https://issues.apache.org/jira/browse/LOG4J2-1802?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16429889#comment-16429889
]
ASF subversion and git services commented on LOG4J2-1802:
---------------------------------------------------------
Commit 77a3712df0364e73ae5aa7bbfaaab58c2f738efb in logging-log4j2's branch
refs/heads/master from [~jvz]
[ https://git-wip-us.apache.org/repos/asf?p=logging-log4j2.git;h=77a3712 ]
LOG4J2-1802: Convert programmatic config manual page to asciidoc
> 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
(v7.6.3#76005)
