You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@qpid.apache.org by "Alan Conway (JIRA)" <ji...@apache.org> on 2016/06/22 16:03:58 UTC
[jira] [Commented] (DISPATCH-399) Convert documentation to asciidoc
format
[ https://issues.apache.org/jira/browse/DISPATCH-399?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15344615#comment-15344615 ]
Alan Conway commented on DISPATCH-399:
--------------------------------------
Review at https://reviews.apache.org/r/49031/
> Convert documentation to asciidoc format
> ----------------------------------------
>
> Key: DISPATCH-399
> URL: https://issues.apache.org/jira/browse/DISPATCH-399
> Project: Qpid Dispatch
> Issue Type: Improvement
> Components: Documentation
> Affects Versions: 0.6.0
> Reporter: Alan Conway
> Assignee: Alan Conway
> Priority: Minor
>
> asciidoc format is becoming more popular for documentation and has several advantages over RST + sphinx.
> - Mature, widely-used DocBook model without painful XML syntax
> - Multi-file documents and entity substitution are standard in asciidoc
> (Sphinx has non-standard extensions, but not defined by RST)
> - simpler, more flexible tools, fewer generation steps.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscribe@qpid.apache.org
For additional commands, e-mail: dev-help@qpid.apache.org