You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@qpid.apache.org by "Robbie Gemmell (Jira)" <ji...@apache.org> on 2019/11/12 11:47:00 UTC
[jira] [Created] (DISPATCH-1479) multicast/routing behaviour doc
improvements
Robbie Gemmell created DISPATCH-1479:
----------------------------------------
Summary: multicast/routing behaviour doc improvements
Key: DISPATCH-1479
URL: https://issues.apache.org/jira/browse/DISPATCH-1479
Project: Qpid Dispatch
Issue Type: Task
Components: Documentation
Reporter: Robbie Gemmell
Assignee: Ben Hardesty
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: dev-unsubscribe@qpid.apache.org
For additional commands, e-mail: dev-help@qpid.apache.org