Re: [ServiceWorker] Please deploy dfn.js or something similar (#489)

> You can if you do a <dfn> for the construct outside of the <pre class=idl>. Then Bikeshed will just link the IDL to your dfn. This is common practice for methods and attributes, so their anchors are actually close to their prose definitions.

Ah, good point. Not sure why it never occurred to me to specify explicit ids for such dfn's. I guess because unlike for every other dfn bikeshed doesn't complain about having to auto-generate ids for them... I guess that just leaves the question if we want to use the auto-generated "whatwg style" ids or keep using the currently used explicit ones. Probably keeping IDs stable is a good idea in that case, since all the ids are there already so it's not actually any more work. For future additions using watwg style IDL IDs might make sense though.


> Note that Bikeshed does not currently have dfn.js built in. You can just link it in yourself for now, I'm just noting that moving to Bikeshed will not actually solve the problem this issue was opened for. ^_^

Ah, good point. I should have probably opened a separate issue for the actual bikeshed migration in that case. But it doesn't look like adding dfn.js support should be very hard either way.

---
Reply to this email directly or view it on GitHub:
https://github.com/slightlyoff/ServiceWorker/issues/489#issuecomment-182020124

Received on Tuesday, 9 February 2016 19:29:01 UTC