From 0a08f40f51ed3f9b75ddfecaa04d7a4a9cb13501 Mon Sep 17 00:00:00 2001 From: Doug Davis Date: Thu, 13 Jun 2019 17:14:55 -0700 Subject: [PATCH] v0.3 Signed-off-by: Doug Davis --- README.md | 18 +++++++++--------- SDK.md | 2 +- amqp-format.md | 2 +- amqp-transport-binding.md | 6 +++--- extensions/dataref.md | 4 ++-- http-transport-binding.md | 18 +++++++++--------- http-webhook.md | 2 +- json-format.md | 14 +++++++------- mqtt-transport-binding.md | 8 ++++---- nats-transport-binding.md | 4 ++-- primer.md | 2 +- protobuf-format.md | 4 ++-- roadmap.md | 2 +- spec.md | 6 +++--- 14 files changed, 46 insertions(+), 46 deletions(-) diff --git a/README.md b/README.md index 372818b3a..154fc8eb4 100644 --- a/README.md +++ b/README.md @@ -27,19 +27,19 @@ The following documents are available: | | Latest Release | Working Draft | | :---------------------------- | :-----------------------------------------------------------------------------: | :---------------------------------------------------------------------------------: | | **Core Specification:** | -| CloudEvents | [v0.2](https://github.com/cloudevents/spec/blob/v0.2/spec.md) | [master](https://github.com/cloudevents/spec/blob/master/spec.md) | +| CloudEvents | [v0.3](https://github.com/cloudevents/spec/blob/v0.3/spec.md) | [master](https://github.com/cloudevents/spec/blob/master/spec.md) | | | | **Optional Specifications:** | -| 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) | +| HTTP Transport Binding | [v0.3](https://github.com/cloudevents/spec/blob/v0.3/http-transport-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/http-transport-binding.md) | +| JSON Event Format | [v0.3](https://github.com/cloudevents/spec/blob/v0.3/json-format.md) | [master](https://github.com/cloudevents/spec/blob/master/json-format.md) | +| Web hook | [v0.3](https://github.com/cloudevents/spec/blob/v0.3/http-webhook.md) | [master](https://github.com/cloudevents/spec/blob/master/http-webhook.md) | +| MQTT Transport Binding | [v0.3](https://github.com/cloudevents/spec/blob/v0.3/mqtt-transport-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/mqtt-transport-binding.md) | +| NATS Transport Binding | [v0.3](https://github.com/cloudevents/spec/blob/v0.3/nats-transport-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/nats-transport-binding.md) | +| AMQP Event Format | [v0.3](https://github.com/cloudevents/spec/blob/v0.3/amqp-format.md) | [master](https://github.com/cloudevents/spec/blob/master/amqp-format.md) | +| AMQP Transport Binding | [v0.3](https://github.com/cloudevents/spec/blob/v0.3/amqp-transport-binding.md) | [master](https://github.com/cloudevents/spec/blob/master/amqp-transport-binding.md) | | | | **Additional Documentation:** | -| Primer | [v0.2](https://github.com/cloudevents/spec/blob/v0.2/primer.md) | [master](https://github.com/cloudevents/spec/blob/master/primer.md) | +| Primer | [v0.3](https://github.com/cloudevents/spec/blob/v0.3/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) | | Proprietary Specifications | - | [master](https://github.com/cloudevents/spec/blob/master/proprietary-specs.md) | diff --git a/SDK.md b/SDK.md index 56c504260..8d07ebfda 100644 --- a/SDK.md +++ b/SDK.md @@ -1,4 +1,4 @@ -# CloudEvents SDK +# CloudEvents SDK - Version 0.3 The intent of this document to describe bare minimum set of requirements for a new SDKs. diff --git a/amqp-format.md b/amqp-format.md index 2010f46f6..1f2010b70 100644 --- a/amqp-format.md +++ b/amqp-format.md @@ -1,4 +1,4 @@ -# AMQP Event Format for CloudEvents +# AMQP Event Format for CloudEvents - Version 0.3 ## Abstract diff --git a/amqp-transport-binding.md b/amqp-transport-binding.md index b13f5e2a8..50a7b1aa6 100644 --- a/amqp-transport-binding.md +++ b/amqp-transport-binding.md @@ -1,4 +1,4 @@ -# AMQP Transport Binding for CloudEvents +# AMQP Transport Binding for CloudEvents - Version 0.3 ## Abstract @@ -201,7 +201,7 @@ content-type: application/json; charset=utf-8 ----------- application-properties ----------- -cloudEvents:specversion: 0.3-wip +cloudEvents:specversion: 0.3 cloudEvents:type: com.example.someevent cloudEvents:time: 2018-04-05T03:56:24Z cloudEvents:id: 1234-1234-1234 @@ -263,7 +263,7 @@ content-type: application/cloudevents+json; charset=utf-8 ------------- application-data -------------------------- { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someevent", ... further attributes omitted ... diff --git a/extensions/dataref.md b/extensions/dataref.md index d4cf4dcd9..0fdfc2da8 100644 --- a/extensions/dataref.md +++ b/extensions/dataref.md @@ -47,7 +47,7 @@ both `data` and `dataref` (serialized as JSON): ``` JSON { - "specversion" : "0.2", + "specversion" : "0.3", "type" : "com.github.pull.create", "source" : "https://github.com/cloudevents/spec/pull/123", "id" : "A234-1234-1234", @@ -62,7 +62,7 @@ The following example shows a CloudEvent in which a middleware has replaced the ``` JSON { - "specversion" : "0.2", + "specversion" : "0.3", "type" : "com.github.pull.create", "source" : "https://github.com/cloudevents/spec/pull/123", "id" : "A234-1234-1234", diff --git a/http-transport-binding.md b/http-transport-binding.md index a8ebe7cbe..01ba90359 100644 --- a/http-transport-binding.md +++ b/http-transport-binding.md @@ -1,4 +1,4 @@ -# HTTP Transport Binding for CloudEvents - Version 0.3-wip +# HTTP Transport Binding for CloudEvents - Version 0.3 ## Abstract @@ -233,7 +233,7 @@ request: ```text POST /someresource HTTP/1.1 Host: webhook.example.com -ce-specversion: 0.3-wip +ce-specversion: 0.3 ce-type: com.example.someevent ce-time: 2018-04-05T03:56:24Z ce-id: 1234-1234-1234 @@ -251,7 +251,7 @@ This example shows a response containing an event: ```text HTTP/1.1 200 OK -ce-specversion: 0.3-wip +ce-specversion: 0.3 ce-type: com.example.someevent ce-time: 2018-04-05T03:56:24Z ce-id: 1234-1234-1234 @@ -310,7 +310,7 @@ Content-Type: application/cloudevents+json; charset=utf-8 Content-Length: nnnn { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someevent", ... further attributes omitted ... @@ -331,7 +331,7 @@ Content-Type: application/cloudevents+json; charset=utf-8 Content-Length: nnnn { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someevent", ... further attributes omitted ... @@ -387,7 +387,7 @@ Content-Length: nnnn [ { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someevent", ... further attributes omitted ... @@ -397,7 +397,7 @@ Content-Length: nnnn } }, { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someotherevent", ... further attributes omitted ... @@ -420,7 +420,7 @@ Content-Length: nnnn [ { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someevent", ... further attributes omitted ... @@ -430,7 +430,7 @@ Content-Length: nnnn } }, { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someotherevent", ... further attributes omitted ... diff --git a/http-webhook.md b/http-webhook.md index 1144c6aef..3c10eb900 100644 --- a/http-webhook.md +++ b/http-webhook.md @@ -1,4 +1,4 @@ -# HTTP 1.1 Web Hooks for Event Delivery +# HTTP 1.1 Web Hooks for Event Delivery - Version 0.3 ## Abstract diff --git a/json-format.md b/json-format.md index b954ff54e..28afaf4f4 100644 --- a/json-format.md +++ b/json-format.md @@ -1,4 +1,4 @@ -# JSON Event Format for CloudEvents - Version 0.3-wip +# JSON Event Format for CloudEvents - Version 0.3 ## Abstract @@ -109,7 +109,7 @@ The following table shows exemplary mappings: | CloudEvents | Type | Exemplary JSON Value | | --------------- | ------------- | ------------------------------- | | type | String | "com.example.someevent" | -| specversion | String | "0.3-wip" | +| specversion | String | "0.3" | | source | URI-reference | "/mycontext" | | id | String | "1234-1234-1234" | | time | Timestamp | "2018-04-05T17:31:00Z" | @@ -173,7 +173,7 @@ Example event with `String`-valued `data`: ```JSON { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someevent", "source" : "/mycontext", "id" : "A234-1234-1234", @@ -191,7 +191,7 @@ Example event with `Binary`-valued data ```JSON { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someevent", "source" : "/mycontext", "id" : "B234-1234-1234", @@ -210,7 +210,7 @@ or [JSON data](#31-special-handling-of-the-data-attribute) data: ```JSON { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someevent", "source" : "/mycontext", "id" : "C234-1234-1234", @@ -260,7 +260,7 @@ second with JSON data. ```JSON [ { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someevent", "source" : "/mycontext/4", "id" : "B234-1234-1234", @@ -273,7 +273,7 @@ second with JSON data. "data" : "... base64 encoded string ..." }, { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someotherevent", "source" : "/mycontext/9", "id" : "C234-1234-1234", diff --git a/mqtt-transport-binding.md b/mqtt-transport-binding.md index dabd639c7..2cdefeb2d 100644 --- a/mqtt-transport-binding.md +++ b/mqtt-transport-binding.md @@ -1,4 +1,4 @@ -# MQTT Transport Binding for CloudEvents +# MQTT Transport Binding for CloudEvents - Version 0.3 ## Abstract @@ -197,7 +197,7 @@ Content Type: application/json; charset=utf-8 ------------- User Properties ---------------- -specversion: 0.3-wip +specversion: 0.3 type: com.example.someevent time: 2018-04-05T03:56:24Z id: 1234-1234-1234 @@ -259,7 +259,7 @@ Content Type: application/cloudevents+json; charset=utf-8 ------------------ payload ------------------- { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someevent", ... further attributes omitted ... @@ -284,7 +284,7 @@ Topic Name: mytopic ------------------ payload ------------------- { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someevent", ... further attributes omitted ... diff --git a/nats-transport-binding.md b/nats-transport-binding.md index 93825ae56..e89728888 100644 --- a/nats-transport-binding.md +++ b/nats-transport-binding.md @@ -1,4 +1,4 @@ -# NATS Transport Binding for CloudEvents +# NATS Transport Binding for CloudEvents - Version 0.3 ## Abstract @@ -128,7 +128,7 @@ Subject: mySubject ------------------ payload ------------------- { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.example.someevent", ... further attributes omitted ... diff --git a/primer.md b/primer.md index 6d23320f0..a6c8041dc 100644 --- a/primer.md +++ b/primer.md @@ -1,4 +1,4 @@ -# CloudEvents Primer +# CloudEvents Primer - Version 0.3 ## Abstract diff --git a/protobuf-format.md b/protobuf-format.md index 59ea1de35..d5ba098a5 100644 --- a/protobuf-format.md +++ b/protobuf-format.md @@ -1,4 +1,4 @@ -# Protocol Buffers Event Format for CloudEvents - Version 0.3-wip +# Protocol Buffers Event Format for CloudEvents - Version 0.3 ## Abstract @@ -102,7 +102,7 @@ CloudEventMap event = CloudEventMap.newBuilder() .putValue( "specversion", CloudEventAny.newBuilder() - .setStringValue("0.3-wip") + .setStringValue("0.3") .build()) .putValue( "time", diff --git a/roadmap.md b/roadmap.md index 2e220189f..ab778bf14 100644 --- a/roadmap.md +++ b/roadmap.md @@ -55,7 +55,7 @@ _0.2_ - Completed - 2018/12/06 1. Define the set of protocol and serialization mappings we're going to produce for 0.4 milestone -_0.3_ +_0.3_ - Completed - 2019/06/13 1. Resolve all known "proposed optional attributes" issues 1. Resolve all known "security related" issues diff --git a/spec.md b/spec.md index f8da00047..e7c3cc378 100644 --- a/spec.md +++ b/spec.md @@ -1,4 +1,4 @@ -# CloudEvents - Version 0.3-wip +# CloudEvents - Version 0.3 ## Abstract @@ -267,7 +267,7 @@ The following attributes are REQUIRED to be present in all CloudEvents: - 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.3-wip` when referring to this version of the + producers MUST use a value of `0.3` when referring to this version of the specification. - Constraints: - REQUIRED @@ -520,7 +520,7 @@ The following example shows a CloudEvent serialized as JSON: ```JSON { - "specversion" : "0.3-wip", + "specversion" : "0.3", "type" : "com.github.pull.create", "source" : "https://github.com/cloudevents/spec/pull", "subject" : "123",