ReSpec: auto-linking to WebIDL stypes

• From: Marcos Caceres <marcos@marcosc.com>
• Date: Tue, 21 Feb 2017 20:39:41 -0800
• To: spec-prod <spec-prod@w3.org>
• Message-ID: <CAAci2aBufJQu_K1CO7UHGmoUn9M=6J1jACFFTEvychbnkgt7vw@mail.gmail.com>

Hi ReSpec users,

If you use WebIDL in your specs,  ReSpec now "non-normatively"
auto-links well-known types to the WebIDL Spec (REC 2016) for you.
Examples include Promise, DOMString, etc. It also auto links some
known HTML5.1 types (e.g., EventHandler).

If you want to make your spec normatively reference WebIDL, then just
cite "[[!WebIDL]]" somewhere (same for HTML51).

For example:

```
This specification depends on [[!WebIDL]] and [[!HTML51]].
```

And WebIDL and HTML51 will magically appear in the Normative References.

An example (click on DOMString, for instance):
https://w3c.github.io/browser-payment-api/#paymentrequest-interface

Happy spec'ing!

Received on Wednesday, 22 February 2017 04:40:16 UTC