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/21 13:10:58 UTC

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

Alan Conway created DISPATCH-399:
------------------------------------

             Summary: 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