[heycam/webidl] Poorly worded normative requirement could be improved (#548)

Filing this only because we implemented this incorrectly, and had to re-read it 10 more times before it [sort of] made sense :)

> The [Exposed] extended attribute must not be specified both on an interface, mixin, or namespace member, and on the partial interface, partial interface mixin, or partial namespace definition the member is declared on.

Two things: 

Clarify that its the member being described--this is revealed only via inspection of the hyperlink: e.g.,:

> The [Exposed] extended attribute must not be specified both on an interface **member**, mixin **member**, or namespace member, and on the partial interface, partial interface mixin, or partial namespace definition the member is declared on.

This makes it sound like its possible to have the same member defined both in a partial interface and non-partial interface. This obviously can't happen. A better phasing might be:

> The [Exposed] extended attribute must not be specified both on the members and on the member's host interface, where the host interface is a partial interface, partial mixin interface, or partial namespace.

That makes much more sense to me.

-- 
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
https://github.com/heycam/webidl/issues/548

Received on Thursday, 12 April 2018 22:42:07 UTC