Merge commits from webscreens/xrefs

[markafoltz]

• Adds ES6 spec
• Adds Promises Guide
• Adds Typed Array spec

[annevk]

I removed Typed Array on purpose. [ECMASCRIPT] should be used instead. We should probably update ECMASCRIPT to point to the HTML version though (but not add a new entry for it).

[sideshowbarker]

I removed Typed Array on purpose. [ECMASCRIPT] should be used instead. We should probably update ECMASCRIPT to point to the HTML version though (but not add a new entry for it).

Before anybody does that, should probably check with @jorendorff to find out if the HTML version will continued to be maintained going forward. (I know he was looking for somebody to take over maintenance of it but last I heard I don't know if he'd found any volunteers yet.)

[markafoltz]

ECMASCRIPT defines neither ArrayBuffer nor ArrayBufferView.

ES6 defines ArrayBuffer so I moved the cross reference there.

I retained TYPEDARRAY since it's the sole reference for ArrayBufferView.

How to proceed?

[annevk]

https://heycam.github.io/webidl/#common-ArrayBufferView is the new ArrayBufferView reference. If this is for the Presentation API you probably want to use BufferSource from IDL however, as well as its construct for getting data out of BufferSource.

[markafoltz]

Thanks for the suggestions. Removed TYPEDARRAY for good and added a ref for BufferSource for future use (will bring it up in the WG).

PTAL

[annevk]

Actually, thinking about this more all you should need here is a reference to IDL. IDL should have normative promise terminology that you can use. And IDL needs to handle the abstraction between your specification and JavaScript. We might still want the promise guide in references.json, but not sure.

[markafoltz]

Okay, removed ES6 in favor of WEBIDL for Promise and ArrayBuffer.

[markafoltz]

@annevk Any further feedback on this PR?

[annevk]

Thanks!