W3C home > Mailing lists > Public > public-web-bluetooth-log@w3.org > April 2015

Re: [web-bluetooth] Switch to ReSpec's contiguous IDL mode.

From: Jeffrey Yasskin via GitHub <sysbot+gh@w3.org>
Date: Thu, 16 Apr 2015 17:46:25 +0000
To: public-web-bluetooth-log@w3.org
Message-ID: <issue_comment.created-93797409-1429206384-sysbot+gh@w3.org>
@anssiko Thanks. The contiguous IDL support actually came out of a bug
 I filed about `noLegacyStyle`dropping the member documentation 
(https://github.com/w3c/respec/issues/334). I'm using `noLegacyStyle` 
in this patch because of https://github.com/w3c/respec/issues/427, but
 once I fix that in ReSpec, I can probably drop `noLegacyStyle` 
entirely.

---





<sup>**[index.html, line 930 
\[r2\]](https://reviewable.io:443/reviews/webbluetoothcg/web-bluetooth/102#-JmyAaSrxlBjmJX-MUSc)**
 ([raw 
file](https://github.com/webbluetoothcg/web-bluetooth/blob/1bf2faf58ad22a14c544c01bb224dbd3bad454aa/index.html#L930)):</sup>
Yeah, in a note we should use simpler English. Done.

---

<sup>**[index.html, line 987 
\[r1\]](https://reviewable.io:443/reviews/webbluetoothcg/web-bluetooth/102#-JmuQ1zXyPDpiq96G0Hx)**
 ([raw 
file](https://github.com/webbluetoothcg/web-bluetooth/blob/56d3238dea4fcfe4475af1e45c7ad7b1ba2a097b/index.html#L987)):</sup>
@marcoscaceres Thanks, I've switched to Anne's style from the fetch 
spec.

@scheib, I think you have a good point that it'd be good to have 
English descriptions of the purpose of these methods in addition to 
the standardese describing how they work. I'm thinking about moving 
the "Foo attributes" notes to always be right after their IDL, and 
then adding prose descriptions of the methods there too. I could put 
examples immediately after that...

---

<sup>**[index.html, line 1489 
\[r2\]](https://reviewable.io:443/reviews/webbluetoothcg/web-bluetooth/102#-JmyBngxlK87umnYWtF5)**
 ([raw 
file](https://github.com/webbluetoothcg/web-bluetooth/blob/1bf2faf58ad22a14c544c01bb224dbd3bad454aa/index.html#L1489)):</sup>
`UUID.parse` doesn't exist anymore, since UUIDs are now just 
`DOMString`s. I've removed the extraneous calls.

---


---

Comments from the [review on 
Reviewable.io](https://reviewable.io:443/reviews/webbluetoothcg/web-bluetooth/102)
<!-- Sent from Reviewable.io -->


-- 
GitHub Notif of comment by jyasskin
See 
https://github.com/WebBluetoothCG/web-bluetooth/pull/102#issuecomment-93797409
Received on Thursday, 16 April 2015 17:46:35 UTC

This archive was generated by hypermail 2.3.1 : Thursday, 16 April 2015 17:46:35 UTC