-
Notifications
You must be signed in to change notification settings - Fork 14
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Clarification of events_delivered #109
Conversation
Clarification of events_delivered
Updated text
…penid/sharedsignals into events-delivered-clarification
transmitter MAY decide to deliver only a subset of events represented by | ||
this intersection. These events MAY be delivered over the Event Stream. A | ||
Receiver MUST rely on the values received in this field to understand which | ||
event types it can expect from the Transmitter. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Suggested wording:
events_delivered
Transmitter-Supplied: An array of URIs identifying the set of events that the Transmitter SHALL include in the stream. This is a subset of the intersection of "events_supported" and "events_requested". A Receiver MUST rely on the values received in this field to understand which event types it can expect from the Transmitter.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is a subset of the intersection of "events_supported" and "events_requested"
I feel the above statement suggests that it will always be a subset, which may not be true.
If you are referring to "A set is a subset of itself" principle to describe this, I feel it may not be clear to an ordinary reader.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
If there's a mathematical term to specify the subset that isn't the "proper subset", then we can include that. In normative text, I prefer precision, but happy to consider opinions of other members. Perhaps we can say: "This is a subset (not necessarily a proper subset) of ..."
Following up on #117 |
Clarification of events_delivered from the past calls
The transmitter may reserve rights to deliver events on certain occasions such as (but not limited to) -
Discussion contexts -