Justin Ross created DISPATCH-509:
------------------------------------

             Summary: Improve the qdrouterd.conf man page
                 Key: DISPATCH-509
                 URL: https://issues.apache.org/jira/browse/DISPATCH-509
             Project: Qpid Dispatch
          Issue Type: Improvement
          Components: Documentation
    Affects Versions: 0.6.1
            Reporter: Justin Ross


* AFAICT, the addrPort and connectionRole annotation sections are not useful to 
end users; the only one that people care about as an independent entity is 
sslProfile

* A lot of space is spent documenting deprecated attributes, often first, 
before the recommended ones; perhaps we should not document the deprecated ones 
at all, or move them to a dedicated section

* The examples at the beginning use deprecated attribute syntax

* The router section mixes important attributes (id, mode) with a bunch of 
tweakables; these are all presented as having equal importance; I recommend a 
wholly distinct location for all the low-level knobs that users should not have 
to care about



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)

---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@qpid.apache.org
For additional commands, e-mail: dev-h...@qpid.apache.org

Reply via email to