[w3c/manifest] Tidy up the install event specification (#473)

I'm looking at implementing the `install` event in Chrome and there are a few things that are implied but not explicit in the [Installation Events](https://w3c.github.io/manifest/#installation-events) section.

1. It doesn't explicitly state the type/interface of the event object (which I assume is [Event](https://dom.spec.whatwg.org/#event) because there's no special metadata).
2. The [Installation](https://w3c.github.io/manifest/#installation) algorithm states when to fire the `"install"` event at the *window* object, but this isn't mentioned or linked up in the [Installation Events](https://w3c.github.io/manifest/#installation-events) section. It isn't explicit that there's a connection between the `"install"` event being fired in Section 2.4 and the `oninstall` IDL attribute. (This section doesn't ever mention the circumstances under which the event is dispatched, despite it being mentioned previously.)

Bascially, you can figure out what's going on from reading the example, but I feel it isn't concrete in the spec, the way [events in Service Workers](https://www.w3.org/TR/service-workers/#document-context-events) spec are defined.

Also, I'm not really familiar with the way events are normally added to the Window object (please correct me if ignorant), but I didn't think defining a mixin interface was necessary. In WebIDL, can't you just write:

```WebIDL
partial interface Window {
  attribute EventHandler oninstall;
}
```
to extend the Window object without it having to implement a new interface?

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

Received on Tuesday, 28 June 2016 01:08:53 UTC