Uploaded image for project: 'Qpid Dispatch'
  1. Qpid Dispatch
  2. DISPATCH-1479

multicast/routing behaviour doc improvements

    XMLWordPrintableJSON

Details

    • Improvement
    • Status: Closed
    • Minor
    • Resolution: Fixed
    • None
    • 1.12.0
    • Documentation
    • None

    Description

      The description of the multicast 'accepted' behaviour could be improved and simplified. It is currently described as:

      Either:
      
      * All consumers received the message,
      
      * Or, at least one consumer received the message, but no consumers rejected it.
      

      (From http://qpid.apache.org/releases/qpid-dispatch-1.9.0/user-guide/index.html#message_settlement_and_reliability, which seems to now be sourced on master from https://github.com/apache/qpid-dispatch/blob/master/docs/books/modules/user-guide/routing.adoc)

       

      The 'received the message' bit could perhaps be clearer, e.g. by changing to 'accepted the message' (same would also apply in the anycast column), since many consumers may have received but not accepted the message.

      It also feels like the either-or distinction should just be removed, leaving only an 'at least one' style description. I dont believe there is a way to discern the number of recipients that have accepted, its just known 1-n consumers accepted without any reject, so it seems more confusing to describe it as an 'either or' situation.

       

      Related, the routing.adoc file referenced above seems to be an updated variant covering older content from https://github.com/apache/qpid-dispatch/blob/master/docs/books/modules/user-guide/message-routing.adoc and https://github.com/apache/qpid-dispatch/blob/master/docs/books/modules/user-guide/link-routing.adoc which each say they are included in routing.adoc but dont actually appear to be. Their content seems stale too, so perhaps they can be deleted?

      Attachments

        Issue Links

          Activity

            People

              bhardesty Ben Hardesty
              robbie Robbie Gemmell
              Votes:
              0 Vote for this issue
              Watchers:
              3 Start watching this issue

              Dates

                Created:
                Updated:
                Resolved: