Initial stab at issue #116.

Author: independentid

openid-sharedsignals-framework-1_0.md

@@ -837,17 +837,42 @@ delivery
 
 >   method
 
-> > **Receiver-Supplied**, the specific delivery method to be used. This can be
-    any one of "urn:ietf:rfc:8935" (push) or "urn:ietf:rfc:8936" (poll), but
-    not both.
+> > **Requestor-Supplied**, the specific delivery method to be used. This can be
+    any one of "urn:ietf:rfc:8935" (push transmitter), "urn:ietf:rfc:8936" (poll
+    transmitter), "urn:ietf:rfc:8935:receive" (push receiver), or 
+    "urn:ietf:rfc:8936:receive" (poll receiver) but not more than one.0
 
 >   endpoint_url
 
 > > The location at which the push or poll delivery will take place. If the
     `method` value is "urn:ietf:rfc:8935" (push), then this value MUST
-    be supplied by the Receiver.  If the `method` value is
-    "urn:ietf:rfc:8936" (poll), then this value MUST be supplied by the
-    Transmitter.
+    be supplied by the requestor (from the receiver).  If the `method` value is
+    "urn:ietf:rfc:8936" (poll), then this value is supplied in the response
+    by the transmitting server. If the `method` value is "urn:ietf:rfc:8935:receive" 
+    than the receiver server SHALL respond with a supplied value. And, if the 
+    `method` value is "urn:ietf:rfc:8936:receive", than the value is supplied
+    by the requestor based on the value issued by the transmitter.
+
+>   authorization_header
+
+> > The HTTP Authorization header to be used, if any, when delivering events. 
+    * Method `urn:ietf:rfc:8935` - provided by the requestor to the trasmitter to
+      use with the receiver supplied `endpoint_url`.
+    * Method `urn:ietf:rfc:8936` - asserted in the stream creation response
+      by the transmitter for use by the receiver.
+    * Method `urn:ietf:rfc8935:receive` - asserted in the stream creation 
+      response by the receiver for use by the transmitter.
+    * Method `urn:ietf:rfc8936:receive` - provided by the requestor to the
+      receiver with the transmitter supplied `endpoint_url`.
+
+>   poll_config
+
+> > An object containing a set of RFC8936 polling parameters requested to be
+    used by a polling receiver when polling a transmitter. The parameters specified
+    MAY include `maxEvnets`, `returnImmediately` and `timeoutSecs`. The receiver
+    MAY choose to override these values and assert the final settings in its 
+    response. When omitted, the default behavior described by RFC8936 SHALL be
+    used.
 
 min_verification_interval
 
@@ -870,7 +895,7 @@ the Event Transmitter responds with a "201 Created" response containing a
 [JSON][RFC7159] representation of the stream’s configuration in the body.
 
 The HTTP POST request MAY contain the Receiver-Supplied values of the Stream
-Configuration ({{stream-config}}) object:
+Configuration ({{stream-config}}) object, for example:
 
 * `events_requested`
 * `delivery` : Note that in the case of the POLL method, the `endpoint_url` value is
@@ -881,7 +906,26 @@ MUST assume that the `method` is "urn:ietf:rfc:8936" (poll). The
 Transmitter MUST include a `delivery` property in the response with this
 `method` property and a `endpoint_url` property.
 
-The following is a non-normative example request to create an Event Stream:
+The following table describes each method, the attributes, their mutability, and
+whether transmitter or receiver asserts the values relative to the stream creation requestor.
+
+| Method                    | Attribute            | Generated By | Mutability |
+| :-------------------------| :--------------------| :-----------| :----------|
+| Push Receiver             |                      |             |           |
+| urn:ietf:rfc:8935:receive | endpoint_url         | receiver    | generated |
+| urn:ietf:rfc:8935:receive | authorization_header | receiver    | generated | 
+| Push Transmitter          |                      |             |           |
+| urn:ietf:rfc:8935         | endpoint_url         | receiver    | modifiable |
+| urn:ietf:rfc:8935         | authorization_header | receiver    | modifiable |
+| Poll Receiver             |                      |             |           |
+| urn:ietf:rfc:8936:receive | endpoint_url         | transmitter | modfiable |
+| urn:ietf:rfc:8936:receive | authorization_header | transmitter | modifiable |
+| urn:ietf:rfc:8936:receive | poll_config          |             | modifiable |
+| Poll Transmitter          |                      |             |            |
+| urn:ietf:rfc:8936         | endpoint_url         | transmitter | generated |
+| urn:ietf:rfc:8936         | authorization_header | transmitter | generated |
+
+The following is a non-normative example request to create a Push Transmitter Event Stream:
 
 ~~~ http
 POST /ssf/stream HTTP/1.1