New text for guidance on exposing interfaces everywhere

w3ctag / design-principles

A small-but-growing set of design principles collected by the TAG while reviewing specifications

https://w3ctag.github.io/design-principles

178 stars 46 forks source link

New text for guidance on exposing interfaces everywhere #510

Open ptomato opened 2 months ago

ptomato commented 2 months ago

Here's an initial draft for text on exposing interfaces everywhere. It's similar to the text I wrote in #509 and the examples I gave there.

Closes: #509

Preview | Diff

caridy commented 2 months ago

this is great, thanks @ptomato for putting the time on this

jyasskin commented 1 month ago

@zcorpan Intuitively I disagree with your argument in https://github.com/whatwg/webidl/issues/1119#issuecomment-2034009609, at least given the guidance in this PR. The downside of requiring review for every new kind of realm is that when we add a new realm type, there's going to be a long string of paper-cuts as developers reach for various utility functions and notice that they haven't yet been added to this particular realm.