[openscreenprotocol] [Editorial] Use compact and readable syntax for protocol messages from Google on 2017-10-06 (public-webscreens@w3.org from October 2017)

From: Google <sysbot+gh@w3.org>
Date: Fri, 06 Oct 2017 22:53:31 +0000
To: public-webscreens@w3.org
Message-ID: <issues.opened-263592528-1507330397-sysbot+gh@w3.org>

mfoltzgoogle has just created a new issue for https://github.com/webscreens/openscreenprotocol:

== [Editorial] Use compact and readable syntax for protocol messages ==
The [control protocol](control_protocol.md) uses ASCII art box diagrams to describe message contents.  These are okay but results in redundancy for common values like URLs and presentation IDs.  Also it takes extra effort to describe repeated values.

As the number of message types will only increase with work on Remote Playback API, I suggest adopting a message description syntax similar to (but much simpler than) TLS 1.3 "Presentation Language" [1].  Then we can simply describe a message with a C-like struct definition and re-use complex types across messages.

[1] https://tools.ietf.org/html/draft-ietf-tls-tls13-21#section-3


Please view or discuss this issue at https://github.com/webscreens/openscreenprotocol/issues/60 using your GitHub account

Received on Friday, 6 October 2017 22:53:20 UTC