- From: François Daoust via GitHub <sysbot+gh@w3.org>
- Date: Tue, 08 Nov 2016 12:10:40 +0000
- To: public-tvcontrol@w3.org
tidoust has just submitted a new pull request for https://github.com/w3c/tvcontrol-api: == Spec converted to WebIDL contiguous mode (automatic conversion) == The conversion hardly changes anything from a visual perspective. Under the hoods, the WebIDL definitions that used `<dl>` have been replaced by more readable `<pre>` definitions (which ReSpec calls the WebIDL contiguous mode). I used a tool to convert the spec and tidied the result so that it remains easy to read and maintain. Note the conversion tool generated the "attributes" and "methods" `<dl>` lists which now have to be manually edited. This may prove to be a pain to maintain: the attribute types and method parameters tables duplicate the info in the WebIDL definitions and are easy to get wrong. On top of that, the descriptions of the methods would best be linked to the procedures for these methods, and that's not the case today. We may switch to a "prose-oriented" approach as in other specs later on. @stevem-tw, this depends on how you'd like to structure the spec from now on. Side note that there were 2 attributes named `name` in the `TVChannel` interface definition. I renamed the one of type `TVChannelAttributes` to `attributes`. The spec now uses the latest version of ReSpec. See https://github.com/w3c/tvcontrol-api/pull/25
Received on Tuesday, 8 November 2016 12:10:46 UTC