googleapis / google-cloudevents

Types for CloudEvents issued by Google
http://git.io/google-cloudevents
Apache License 2.0
143 stars 22 forks source link

docs: First pass at moving the Pub/Sub binding into this repo. #502

Closed jskeet closed 1 year ago

jskeet commented 1 year ago

Original source: https://github.com/google/knative-gcp/blob/main/docs/spec/pubsub-protocol-binding.md

I've modified the text in a few places as the CloudEvents spec wording has been tightened up since that doc was written:

Reading through this, it looks like we don't have a convention for extension attributes, and we don't have any examples of them either. We can approach that in a follow-up PR.

cc @ymalik

jskeet commented 1 year ago

Given docs/ are usually repository docs, and this is actually a CloudEvent spec, perhaps this should be in a spec/ directory?

Happy to do that if we'd prefer - will discuss internally (and add you to that conversation). (I think I'd prefer docs because it's effectively documentation and I can see there being more docs, but I suspect in a spec directory this might always be the only document...)