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: [email protected]
For additional commands, e-mail: [email protected]

Reply via email to