ReSpec WebIDL authoring

Hi,

The way we define WebIDL in ReSpec (using <dl><dt><dd>, now qualified as 
"oldschool") is going to be deprecated down the line:
https://github.com/w3c/respec/issues/395

The new approach (called contiguous WebIDL) uses proper WebIDL fragments 
with accompanying conventions for interlinking, cf:
http://www.w3.org/respec/examples/webidl-contiguous.html

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 
more.

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?

Dom

1. https://github.com/WebBluetoothCG/web-bluetooth/pull/102

Received on Thursday, 23 April 2015 06:53:09 UTC