Skip to content

Commit

Permalink
Merge pull request cloudevents#1155 from duglin/dataref
Browse files Browse the repository at this point in the history
Warn people about dataref
  • Loading branch information
duglin authored Feb 23, 2023
2 parents 4af4b73 + 855b1c0 commit 666a123
Showing 1 changed file with 7 additions and 1 deletion.
8 changes: 7 additions & 1 deletion cloudevents/extensions/dataref.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,13 @@ MUST be identical.
Both `data` and the `dataref` attribute MAY exist at the same time. A middleware
MAY drop `data` when the `dataref` attribute exists, it MAY add
the `dataref` attribute and drop the `data` attribute, or it MAY add the `data`
attribute by using the `dataref` attribute.
attribute by using the `dataref` attribute. Note that since the CloudEvents
specification does not define a mechanism by which a sender can know if the
receiver supports any particular CloudEvent extension, removing the `data`
attribute in favor of just having the `dataref` attribute could yield
unexpected results. As such, removing the `data` attribute SHOULD only be done
when the sender is confident that all receivers support the `dataref`
attribute - via some out-of-band agreement.

## Attributes

Expand Down

0 comments on commit 666a123

Please sign in to comment.