[
https://issues.apache.org/jira/browse/DISPATCH-1479?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Ganesh Murthy updated DISPATCH-1479:
------------------------------------
Issue Type: Improvement (was: Task)
> multicast/routing behaviour doc improvements
> --------------------------------------------
>
> Key: DISPATCH-1479
> URL: https://issues.apache.org/jira/browse/DISPATCH-1479
> Project: Qpid Dispatch
> Issue Type: Improvement
> Components: Documentation
> Reporter: Robbie Gemmell
> Assignee: Ben Hardesty
> Priority: Minor
> Fix For: 1.12.0
>
>
> The description of the multicast 'accepted' behaviour could be improved and
> simplified. It is currently described as:
> {noformat}
> Either:
> * All consumers received the message,
> * Or, at least one consumer received the message, but no consumers rejected
> it.
> {noformat}
> (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?
--
This message was sent by Atlassian Jira
(v8.3.4#803005)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
