[
https://issues.apache.org/jira/browse/DISPATCH-399?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=15346751#comment-15346751
]
Alan Conway commented on DISPATCH-399:
--------------------------------------
Updated the website generation scripts and the "work-in-progress" page on the
site at http://qpid.apache.org/releases/qpid-dispatch-master/index.html
> 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: [email protected]
For additional commands, e-mail: [email protected]
