From c80314d934195167294c0946b817606ff9ce3ef5 Mon Sep 17 00:00:00 2001 From: Doug Davis Date: Thu, 29 Nov 2018 16:38:10 -0800 Subject: [PATCH] v0.2 Signed-off-by: Doug Davis --- README.md | 20 ++++++++++---------- amqp-transport-binding.md | 6 +++--- http-transport-binding.md | 10 +++++----- json-format.md | 10 +++++----- mqtt-transport-binding.md | 8 ++++---- nats-transport-binding.md | 4 ++-- protobuf-format.md | 4 ++-- roadmap.md | 2 +- spec.md | 6 +++--- 9 files changed, 35 insertions(+), 35 deletions(-) diff --git a/README.md b/README.md index a0894fe94..1882e5ea1 100644 --- a/README.md +++ b/README.md @@ -28,20 +28,20 @@ The following documents are available: | | Latest Release | Working Draft | | :--- | :---: | :---: | | **Core Specification:** | -| CloudEvents | [v0.1](https://github.com/cloudevents/spec/blob/v0.1/spec.md) | [master](https://github.com/cloudevents/spec/blob/master/spec.md) | +| CloudEvents | [v0.2](https://github.com/cloudevents/spec/blob/v0.2/spec.md) | [master](https://github.com/cloudevents/spec/blob/master/spec.md) | | | | **Optional Specifications:** | -| HTTP Transport Binding | [v0.1](https://github.com/cloudevents/spec/blob/v0.1/http-transport-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/http-transport-binding.md) | -| JSON Event Format | [v0.1](https://github.com/cloudevents/spec/blob/v0.1/json-format.md) | [master](https://github.com/cloudevents/spec/blob/master/json-format.md) | -| Web hook | - | [master](https://github.com/cloudevents/spec/blob/master/http-webhook.md) | -| MQTT Transport Binding | - | [master](https://github.com/cloudevents/spec/blob/master/mqtt-transport-binding.md) | -| NATS Transport Binding | - | [master](https://github.com/cloudevents/spec/blob/master/nats-transport-binding.md) | -| AMQP Event Format | - | [master](https://github.com/cloudevents/spec/blob/master/amqp-format.md) | -| AMQP Transport Binding | - | [master](https://github.com/cloudevents/spec/blob/master/amqp-transport-binding.md) | +| HTTP Transport Binding | [v0.2](https://github.com/cloudevents/spec/blob/v0.2/http-transport-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/http-transport-binding.md) | +| JSON Event Format | [v0.2](https://github.com/cloudevents/spec/blob/v0.2/json-format.md) | [master](https://github.com/cloudevents/spec/blob/master/json-format.md) | +| Web hook | [v0.2](https://github.com/cloudevents/spec/blob/v0.2/http-webhook.md) | [master](https://github.com/cloudevents/spec/blob/master/http-webhook.md) | +| MQTT Transport Binding | [v0.2](https://github.com/cloudevents/spec/blob/v0.2/mqtt-transport-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/mqtt-transport-binding.md) | +| NATS Transport Binding | [v0.2](https://github.com/cloudevents/spec/blob/v0.2/nats-transport-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/nats-transport-binding.md) | +| AMQP Event Format | [v0.2](https://github.com/cloudevents/spec/blob/v0.2/amqp-format.md) | [master](https://github.com/cloudevents/spec/blob/master/amqp-format.md) | +| AMQP Transport Binding | [v0.2](https://github.com/cloudevents/spec/blob/v0.2/amqp-transport-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/amqp-transport-binding.md) | | | | **Additional Documentation:** | -| Primer | - | [master](https://github.com/cloudevents/spec/blob/master/primer.md) | -| Documented Extensions | | [master](https://github.com/cloudevents/spec/blob/master/documented-extensions.md) | +| Primer | [v0.2](https://github.com/cloudevents/spec/blob/v0.2/primer.md) | [master](https://github.com/cloudevents/spec/blob/master/primer.md) | +| Documented Extensions | - | [master](https://github.com/cloudevents/spec/blob/master/documented-extensions.md) | If you are new to CloudEvents, it is recommended that you start by reading the [Primer](primer.md) for an overview of the specification's diff --git a/amqp-transport-binding.md b/amqp-transport-binding.md index 4a84e0f6a..d76706653 100644 --- a/amqp-transport-binding.md +++ b/amqp-transport-binding.md @@ -195,7 +195,7 @@ content-type: application/json; charset=utf-8 ----------- application-properties ----------- -cloudEvents:specversion: "0.1" +cloudEvents:specversion: "0.2" cloudEvents:type: "com.example.someevent" cloudEvents:time: "2018-04-05T03:56:24Z" cloudEvents:id: "1234-1234-1234" @@ -257,7 +257,7 @@ content-type: application/cloudevents+json; charset=utf-8 ------------- application-data -------------------------- { - "specversion" : "0.1", + "specversion" : "0.2", "type" : "com.example.someevent", ... further attributes omitted ... @@ -296,4 +296,4 @@ content-type: application/cloudevents+json; charset=utf-8 [OASIS-AMQP-1.0]: http://docs.oasis-open.org/amqp/core/v1.0/amqp-core-overview-v1.0.html [message-format]: http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html#section-message-format [data]: http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html#type-data -[app-properties]: http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html#type-application-properties \ No newline at end of file +[app-properties]: http://docs.oasis-open.org/amqp/core/v1.0/os/amqp-core-messaging-v1.0-os.html#type-application-properties diff --git a/http-transport-binding.md b/http-transport-binding.md index 4c66d3e18..f8299cbba 100644 --- a/http-transport-binding.md +++ b/http-transport-binding.md @@ -1,4 +1,4 @@ -# HTTP Transport Binding for CloudEvents - Version 0.1 +# HTTP Transport Binding for CloudEvents - Version 0.2 ## Abstract @@ -220,7 +220,7 @@ request: ``` text POST /someresource HTTP/1.1 Host: webhook.example.com -ce-specversion: "0.1" +ce-specversion: "0.2" ce-type: "com.example.someevent" ce-time: "2018-04-05T03:56:24Z" ce-id: "1234-1234-1234" @@ -238,7 +238,7 @@ This example shows a response containing an event: ``` text HTTP/1.1 200 OK -ce-specversion: "0.1" +ce-specversion: "0.2" ce-type: "com.example.someevent" ce-time: "2018-04-05T03:56:24Z" ce-id: "1234-1234-1234" @@ -297,7 +297,7 @@ Content-Type: application/cloudevents+json; charset=utf-8 Content-Length: nnnn { - "specversion" : "0.1", + "specversion" : "0.2", "type" : "com.example.someevent", ... further attributes omitted ... @@ -318,7 +318,7 @@ Content-Type: application/cloudevents+json; charset=utf-8 Content-Length: nnnn { - "specversion" : "0.1", + "specversion" : "0.2", "type" : "com.example.someevent", ... further attributes omitted ... diff --git a/json-format.md b/json-format.md index bef2521d7..d831b0ef7 100644 --- a/json-format.md +++ b/json-format.md @@ -1,4 +1,4 @@ -# JSON Event Format for CloudEvents - Version 0.1 +# JSON Event Format for CloudEvents - Version 0.2 ## Abstract @@ -109,7 +109,7 @@ The following table shows exemplary mappings: | CloudEvents | Type | Exemplary JSON Value |--------------------|---------------|-------------------------- | type | String | "com.example.someevent" -| specversion | String | "0.1" +| specversion | String | "0.2" | source | URI-reference | "/mycontext" | id | String | "1234-1234-1234" | time | Timestamp | "2018-04-05T17:31:00Z" @@ -174,7 +174,7 @@ Example event with `String`-valued `data`: ``` JSON { - "specversion" : "0.1", + "specversion" : "0.2", "type" : "com.example.someevent", "source" : "/mycontext", "id" : "A234-1234-1234", @@ -192,7 +192,7 @@ Example event with `Binary`-valued data ``` JSON { - "specversion" : "0.1", + "specversion" : "0.2", "type" : "com.example.someevent", "source" : "/mycontext", "id" : "B234-1234-1234", @@ -211,7 +211,7 @@ a `Map` or [JSON data](#31-special-handling-of-the-data-attribute) data: ``` JSON { - "specversion" : "0.1", + "specversion" : "0.2", "type" : "com.example.someevent", "source" : "/mycontext", "id" : "C234-1234-1234", diff --git a/mqtt-transport-binding.md b/mqtt-transport-binding.md index fa8c95612..3d487fa48 100644 --- a/mqtt-transport-binding.md +++ b/mqtt-transport-binding.md @@ -195,7 +195,7 @@ Content Type: application/json; charset=utf-8 ------------- User Properties ---------------- -specversion: "0.1" +specversion: "0.2" type: "com.example.someevent" time: "2018-04-05T03:56:24Z" id: "1234-1234-1234" @@ -257,7 +257,7 @@ Content Type: application/cloudevents+json; charset=utf-8 ------------------ payload ------------------- { - "specversion" : "0.1", + "specversion" : "0.2", "type" : "com.example.someevent", ... further attributes omitted ... @@ -282,7 +282,7 @@ Topic Name: mytopic ------------------ payload ------------------- { - "specversion" : "0.1", + "specversion" : "0.2", "type" : "com.example.someevent", ... further attributes omitted ... @@ -316,4 +316,4 @@ Topic Name: mytopic [RFC2046]: https://tools.ietf.org/html/rfc2046 [RFC2119]: https://tools.ietf.org/html/rfc2119 [RFC3629]: https://tools.ietf.org/html/rfc3629 -[RFC4627]: https://tools.ietf.org/html/rfc4627 \ No newline at end of file +[RFC4627]: https://tools.ietf.org/html/rfc4627 diff --git a/nats-transport-binding.md b/nats-transport-binding.md index a8ef93982..3334a19ff 100644 --- a/nats-transport-binding.md +++ b/nats-transport-binding.md @@ -122,7 +122,7 @@ Subject: mySubject ------------------ payload ------------------- { - "specversion" : "0.1", + "specversion" : "0.2", "type" : "com.example.someevent", ... further attributes omitted ... @@ -155,4 +155,4 @@ Subject: mySubject [RFC2046]: https://tools.ietf.org/html/rfc2046 [RFC2119]: https://tools.ietf.org/html/rfc2119 [RFC3629]: https://tools.ietf.org/html/rfc3629 -[RFC7159]: https://tools.ietf.org/html/rfc7159 \ No newline at end of file +[RFC7159]: https://tools.ietf.org/html/rfc7159 diff --git a/protobuf-format.md b/protobuf-format.md index 81d49a3a3..63d4f2dfb 100644 --- a/protobuf-format.md +++ b/protobuf-format.md @@ -1,4 +1,4 @@ -# Protocol Buffers Event Format for CloudEvents - Version 0.1 +# Protocol Buffers Event Format for CloudEvents - Version 0.2 ## Abstract @@ -109,7 +109,7 @@ CloudEventMap event = CloudEventMap.newBuilder() .putValue( "specversion", CloudEventAny.newBuilder() - .setStringValue("0.1") + .setStringValue("0.2") .build()) .putValue( "time", diff --git a/roadmap.md b/roadmap.md index 48a7c380e..74dfa4f88 100644 --- a/roadmap.md +++ b/roadmap.md @@ -42,7 +42,7 @@ item; they don't imply an order for implementation._ 1. Events are sent by code written by Developer1 and received by code written by Developer2, where Developer1 has no knowledge of Developer2. -*0.2* +*0.2* - Completed - 2018/12/06 1. Incorporate learnings and feedback from interop demo to support wider adoption. diff --git a/spec.md b/spec.md index e2061cde8..b17709129 100644 --- a/spec.md +++ b/spec.md @@ -1,4 +1,4 @@ -# CloudEvents - Version 0.1 +# CloudEvents - Version 0.2 ## Abstract @@ -193,7 +193,7 @@ help intermediate gateways determine how to route the events. * Type: `String` * Description: The version of the CloudEvents specification which the event uses. This enables the interpretation of the context. Compliant event - producers MUST use a value of `0.1` when referring to this version of + producers MUST use a value of `0.2` when referring to this version of the specification. * Constraints: * REQUIRED @@ -295,7 +295,7 @@ The following example shows a CloudEvent serialized as JSON: ``` JSON { - "specversion" : "0.1", + "specversion" : "0.2", "type" : "com.github.pull.create", "source" : "https://github.com/cloudevents/spec/pull/123", "id" : "A234-1234-1234",