Clarify some protocol state and events sections
Created by: claucece
-
On "Protocol states" section, what happens when a TLV type 1 (Disconnected) message is received? This box suggests that we transition to START, but also to FINISHED. -
On "Protocol events" section, who initializes the protocol with the allowed versions? -
On "Protocol events" > "Query Messages" section, why is it required that users can choose which versions to support? -
On "Protocol events" > "Query Messages" section, some information from the version string section is duplicated here. Consider reusing / referencing it. -
On "Protocol events" section, what happens if a single message contains multiple valid query strings and whitespace tags? -
On "Protocol events" > "Receiving plaintext without the whitespace tag" section, this section header should also exclude query messages. -
On "Protocol events" > "Sending an encrypted data message" section, "The ENCRYPTED_MESSAGES state is the only state where a participant is allowed to send encrypted data messages" except when sending offline messages. -
On "Protocol events" > "Receiving an encrypted data message" section, if possible, include a nested diagram showing the nested structure of a message. This should help to clarify the protocol. Something like this: ["?OTR" [ message [ TLV ] ] ] -
On "Protocol events" > "Receiving an encrypted data message" section, are there any TLV types other than 1 (Disconnected) that can be nested inside an encrypted message in this way? -
On "Protocol events" > "Receiving an encrypted data message" section, if a message is received, it is valid, and it can be decrypted, then the spec says to send a heartbeat if no message has been sent in some configurable length of time. Shouldn't this heartbeat happen all the time (not just after receiving a message)? -
On "Protocol events" > "Receiving an Error Message" section, the last part here about OTRv3 is not clear. -
On "Protocol events" > "Receiving a TLV type 1 (Disconnected) Message" section, does this refer to receiving a TLV type 1 message outside of an encrypted data message? If so, how does this reaction differ from the one described in the "Receiving an encrypted data message" section? -
On "Considerations for networks that allow multiple devices", "Doing so allows establishing an OTR channel at the same time with multiple devices from the other participant". Should this be "establishing multiple OTR channels"?