W3C home > Mailing lists > Public > public-webrtc-editors@w3.org > April 2015

ReSpec WebIDL authoring

From: Dominique Hazael-Massieux <dom@w3.org>
Date: Thu, 23 Apr 2015 08:52:15 +0200
Message-ID: <5538969F.2010109@w3.org>
To: public-webrtc-editors@w3.org

The way we define WebIDL in ReSpec (using <dl><dt><dd>, now qualified as 
"oldschool") is going to be deprecated down the line:

The new approach (called contiguous WebIDL) uses proper WebIDL fragments 
with accompanying conventions for interlinking, cf:

At the moment, the two modes are maintained; but clearly there are plans 
for a time where the oldschool mode won't be specifically maintained any 

Switching from oldschool to contiguous is a non-trivial effort (see for 
instance the patch that was required to the bluetooth spec [1]); I think 
there are likely ways to automate or semi-automate it, in which I could 
look if we determine we should switch.

But the main question at this point is whether we should switch, and for 
which specs?


1. https://github.com/WebBluetoothCG/web-bluetooth/pull/102
Received on Thursday, 23 April 2015 06:53:09 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:19:02 UTC