Editorial comments on Web Crypto API

Just a quick review of the spec, but I agree its mature enough to go 
forward as a WG if the editors can check-in descriptions of the latest 
issues.

1. Remove Arun as co-editor.
2. "web browsers to give any web page" -> "web browsers to give any web 
page and native Javascript environments* "
3. My preference is not to give use-cases in this document, but put them 
in a separate WG note.
4. "this specification does not dictate a mandatory set of algorithms 
that must be implemented. " -> "this specification does not dictate a 
mandatory set of algorithms that must be implemented, *although for the 
case of interoperability a number of algorithms are recommended."
5. Instead of "TBD", say "Open Issue". I'd also actually maybe link not 
to the issue tracker, but put the *text* of the issue directly in the 
spec. The point of this FPWD release is to get the broader community to 
think about these issue and give us input, and I'm worried they will be 
too lazy to click those links.
6. Do you want to say "Fire an event called complete." after " Fire an 
event called progress." in "processData(ArrayBufferView buffer)
7. We need some text/IDL under "deriveKey", "importKey", and "exportKey"


Overall, great work!

    cheers,
      harry

Received on Monday, 27 August 2012 17:52:27 UTC