Merge pull request #452 from duglin/v0.3

v0.3
cloudevents · Jun 14, 2019 · 189ad4b · 189ad4b
2 parents 713d5b6 + 0a08f40
commit 189ad4b
Show file tree

Hide file tree

Showing 14 changed files with 46 additions and 46 deletions.
diff --git 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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -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
@@ -1,4 +1,4 @@
-# CloudEvents Primer
+# CloudEvents Primer - Version 0.3
 
 ## Abstract
 

diff --git 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
@@ -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
@@ -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",