Proposal by Eric Haas: suggest interaction diagram for each session too like attached example for Discovery repeat for Subscribe etc... Persuasive : Having visual guidance makes sense to simplify the implementation process Proposed sequence diagrams : Subscription :    Add sequence diagram for a successful subscription using websockets (including subscription confirmation) Unsubscription :    Add sequence diagrams for successful unsubscriptions, both for webhook and websocket implementations Event Notifications :  No sequence diagrams exists   Add sequence diagrams for event notifications, both for webhook and websocket implementations Event Notification Errors : No sequence diagrams exists   Add sequence diagrams for event notification errors, both for webhook and websocket implementations