Uploaded image for project: 'FHIR Specification Feedback'
  1. FHIR Specification Feedback
  2. FHIR-25815

Suggestion. Change word "exchnages" to "channels"

    XMLWordPrintableJSON

Details

    • Icon: Change Request Change Request
    • Resolution: Not Persuasive with Modification
    • Icon: Highest Highest
    • FHIRCast (FHIR)
    • 0.1 [deprecated]
    • Imaging Integration
    • (NA)
    • Subscribing and Unsubscribing
    • Hide

      The text refers to the two exchanges being

      1. Subscription request 
      2. Subscription confirmation

      For the subscription confirmation there are indeed two channels, but that is not what the text refers to.

       Suggestion is to reword the phrase to make this more clear:

       

      Existing wording: 

       

      Subscribing consists of two exchanges:

      • Subscriber requests a subscription at the hub.url url.
      • For hub.channel.type = webhook, Hub confirms the subscription was actually requested by the subscriber by contacting the hub.callback url.
      • For hub.channel.type = websocket, Hub returns a wss url and subscriber establishes websocket connection.

      Unsubscribing works in the same way, except with a single parameter changed to indicate the desire to unsubscribe.

      Proposed wording:

      Subscribing consists of two exchanges:

      • Subscriber requests a subscription at the hub.url url.
      • The hub confirms the subscription was actually requested by the subscriber. This exchange can be implemented in two ways depending on the channel type.
        • For hub.channel.type = webhook, Hub confirms the subscription was actually requested by the subscriber by contacting the hub.callback url.
        • For hub.channel.type = websocket, Hub returns a wss url and subscriber establishes websocket connection.

      Unsubscribing works in the same way, except with a single parameter changed to indicate the desire to unsubscribe.

       

      Show
      The text refers to the two exchanges being Subscription request  Subscription confirmation For the subscription confirmation there are indeed two channels, but that is not what the text refers to.  Suggestion is to reword the phrase to make this more clear:   Existing wording:    Subscribing consists of two exchanges: Subscriber requests a subscription at the hub.url url. For hub.channel.type = webhook , Hub confirms the subscription was actually requested by the subscriber by contacting the hub.callback url. For hub.channel.type = websocket , Hub returns a wss url and subscriber establishes websocket connection. Unsubscribing works in the same way, except with a single parameter changed to indicate the desire to unsubscribe. Proposed wording: Subscribing consists of two exchanges: Subscriber requests a subscription at the hub.url url. The hub confirms the subscription was actually requested by the subscriber. This exchange can be implemented in two ways depending on the channel type. For hub.channel.type = webhook , Hub confirms the subscription was actually requested by the subscriber by contacting the hub.callback url. For hub.channel.type = websocket , Hub returns a wss url and subscriber establishes websocket connection. Unsubscribing works in the same way, except with a single parameter changed to indicate the desire to unsubscribe.  
    • Isaac Vetter / Eric Martin : 5-0-0
    • Clarification
    • Non-substantive

    Description

      Suggestion. Change word "exchnages" to "channels"

      Existing Wording:

      Subscribing consists of two exchanges:

      Proposed Wording:

      Subscribing consists of two channels:

      Attachments

        Activity

          People

            niklas_svenzen Niklas Svenzen (Inactive)
            bvdh Bas van den Heuvel
            Watchers:
            3 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: