Open ghost opened 12 years ago
I agree. The issue tracker for this project already gives us a good history, but it's not a very nice summary of the current "pitfalls". We could start with a simple file that lists the known issues under the doc
directory. I also intend to update the API docs with some notes of warning in the appropriate traps.
Just noting this here for the moment so I don't forget (I do plan to write up a page on this as mentioned above). Two chrome bugs:
http://code.google.com/p/chromium/issues/detail?id=139774
document.body.onclick = Proxy.createFunction({}, function(){})
document.body.onclick will be set to null (if it wasn't already). document.body.addEventListener('click', functionProxy)
will never receive callbacks. (my current workaround is to just wrap the proxy in a minimal actual function when I need a proxy DOM event handler, as I do when bridging between two JS heaps, https://github.com/appjs/appjs/blob/master/lib/bridge.js#L242).
I'm not sure where this would best exist, if anywhere at all, but it seems like it's already been useful just pulling together notes on a few bugs and issues with the various implementations and continuing iteration of those. While they should always be reported as bugs to the tracker for the implementation first, it still seems useful to note them and workarounds for the short term, and also as a kind of historical documentation of the various issues that inevitably come up along the way in implementing new APIs, especially one this grandiose. Individual bug tracs have a tendency to get deeply buried amongst the mountain of issues filed in engine repo history logs without much context to draw from after the fact.