[jira] [Resolved] (DISPATCH-399) Convert documentation to asciidoc format

["Alan Conway (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/DISPATCH-399?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Alan Conway resolved DISPATCH-399.
----------------------------------
       Resolution: Fixed
    Fix Version/s: 0.7.0

> 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
>             Fix For: 0.7.0
>
>
> 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