Discussion of the meaning of optional

[jskeet]

Discussion of the meaning of optional

[jskeet]

Quick audit of the use of "optional" within the cloudevents directory of this repo:

• Lots of descriptions of what OPTIONAL means
• Support for any extension is optional
• WebHook-Request-Callback header is optional
• Description of various attributes as optional
• JSON numbers have an optional - prefix (optional in terms of syntax only, of course - required for negative numbers!)
• Whitespace is optional around header values in HTTP and NATS
• Kafka: "This spec provides an OPTIONAL definition to map the key section of the Kafka record, without constraining the user to implement it nor use it." (Would need to look more carefully to see what that means)
• Data element being optional in XML format

So I think it would be reasonably straightforward to tweak the spec to use "optional" only in terms of "this aspect of data may be present or absent" and use MAY to define features that conformant implementations don't have to implement.

[jskeet]

My next step will be to create a draft PR to separate optionality of data from optionality of implementation, but I haven't made any progress on this yet.

[github-actions]

This issue is stale because it has been open for 30 days with no
activity. Mark as fresh by updating e.g., adding the comment /remove-lifecycle stale.

[jskeet]

/remove-lifecycle stale

[github-actions]

This issue is stale because it has been open for 30 days with no
activity. Mark as fresh by updating e.g., adding the comment /remove-lifecycle stale.

[jskeet]

/remove-lifecycle stale

[github-actions]

This issue is stale because it has been open for 30 days with no
activity. Mark as fresh by updating e.g., adding the comment /remove-lifecycle stale.