25625 2014-05-09 00:33:47 +0000 Provide a better explanation for the (informative) table in Section 18.1 2014-09-26 23:37:23 +0000 1 1 1 Unclassified Web Cryptography Web Cryptography API Document unspecified PC All RESOLVED FIXED P2 normal --- 1 sleevi watsonm public-webcrypto watsonm oldest_to_newest 105522 0 sleevi 2014-05-09 00:33:47 +0000 As raised during the W3C TAG review - https://github.com/w3ctag/spec-reviews/issues/3#issuecomment-41521737 The table in 18.1 is largely presented without context. Provide a better explanation for the context of this table as it relates to the specification. 111948 1 watsonm 2014-09-22 17:47:18 +0000 The existing text states that the table shows operations, but in fact it shows methods. This is one of the sources of confusion. There is not a 1-1 mapping between methods and operations. For example, the deriveKey method makes use of the get length, derive bits and import key operations. 112098 2 watsonm 2014-09-24 18:53:01 +0000 https://dvcs.w3.org/hg/webcrypto-api/rev/d4704a7582c8 https://dvcs.w3.org/hg/webcrypto-api/rev/529c7559a84c I think the specification would be improved if we were more explicit about the difference between the SubtleCrypto methods and the operations supported by algorithms. My suggestion is that we write the operations names with square brackets, so, for example, we would refer to the "encrypt method" and to the "[encrypt] operation". Comments ? 112255 3 watsonm 2014-09-26 15:13:17 +0000 *** Bug 24827 has been marked as a duplicate of this bug. *** 112329 4 watsonm 2014-09-26 23:37:23 +0000 In the absence of comments, I propose we leave things as they are, with the additional explanation I have already provided.