Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve description of EventHandler attributes #103

Closed
martinthomson opened this issue Nov 27, 2014 · 1 comment · Fixed by #119
Closed

Improve description of EventHandler attributes #103

martinthomson opened this issue Nov 27, 2014 · 1 comment · Fixed by #119
Assignees

Comments

@martinthomson
Copy link
Member

Statements of this form are almost completely devoid of information:

This event handler, of type active, MUST be supported by all objects implementing the MediaStream interface.

A simple rewrite makes a big difference:

This event handler, of type active, is fired when the MediaStream becomes active.

And this is throughout.

Chasing down what the conditions are for firing an event is surprisingly difficult without something like this.

As for what I recommend removing, I have no idea why you would have strict normative requirements around support for this and not other things.

@stefhak
Copy link
Contributor

stefhak commented Jan 28, 2015

Labeling as "Editorial" (no functional changes).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
3 participants