This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.
Specification: http://www.whatwg.org/specs/web-apps/current-work/ Multipage: http://www.whatwg.org/C#fire-a-simple-event Complete: http://www.whatwg.org/c#fire-a-simple-event Comment: "created" and "dispatched" should be hyperlinks here. Posted from: 72.229.29.65 User agent: Mozilla/5.0 (X11; Linux i686) AppleWebKit/535.19 (KHTML, like Gecko) Chrome/18.0.1025.7 Safari/535.19
This bug was cloned to create bug 18066 as part of operation convergence.
Aryeh: Where should "created" by hyperlinked to? I think it might make sense to hyperlink all the uses of "fire" and "dispatch", actually. Several people have either suggested it, or been confused by those terms enough that I think it might help. It's a lot of work though.
The linking I think makes sense. Not sure why "create" and "dispatch" need to be hyperlinks. DOM clearly defines the terms "fire" (which includes create) and "dispatch" in detail.
If there's no definition anywhere of "created", then the wording here should be either be changed to a defined term or just removed (". . . must be dispatched . . ."). If there's no definition of what it actually means, I don't see how it adds clarity. I definitely think things like this need to be hyperlinked. Otherwise it's impossible for anyone but a spec guru to understand that the spec actually means something precise, and implementers are rarely spec gurus. Of course, the cost-benefit tradeoff might not warrant the work of a mass change, but at least heavily-referenced uses like this can be changed, and any newly-added uses. Yes, *we* know to look in DOM for things like this, but other people won't, particularly since there are multiple versions of DOM floating around (including now W3C vs. not) and other specs that cover similar ground (DOM 3 Events). DOM 3 Events does indeed define "fire" and "dispatch", which do not mean the same thing as in DOM (it's not precisely defined at all AFAICT): http://dev.w3.org/2006/webapi/DOM-Level-3-Events/html/DOM3-Events.html#glossary-dispatch Random implementers are never going to be able to easily understand modern web specs, given how big and complicated they are these days, but that doesn't mean we need to plant landmines for them.
Fire and dispatch are now hyperlinked. Create just has its English meaning (well, it's computer science meaning, I guess), I don't know what is ambiguous about it. Feel free to reopen if there's something I've missed or if the "create" here is unusually ambiguous.