Improve readability of Blob-related statements #42
Conversation
|
Not very clear about what to do with |
| The <dfn id="dfn-close" method for=Blob>close()</dfn> method is said to <a lt="closed" for=Blob>close</a> a {{Blob}}, | ||
| and must act as follows on the {{Blob}} on which the method has been called: | ||
| The <dfn id="dfn-close" method for=Blob>close()</dfn> method is said to <a lt="closed" for=Blob>close</a> | ||
| the {{Blob}} context object when it acts on the {{Blob}} as follows: |
There was a problem hiding this comment.
I don't really like this rephrasing, in particular using "when" to combine the two sentence fragments sounds wrong to me (but I'm not a native english speaker). I'd rather just get rid of the whole "on the {{Blob}} on which the method has been called" part, but otherwise keep the current text.
There was a problem hiding this comment.
+1 for dropping it.
It's fine to leave updating the .html to me. Not sure what's up with the CLA check either. This change is probably non-substantive enough for that not too matter too much, but I'm not sure what the check exactly is trying to say and what to do about it either. |
|
Marked as non-substantive for IPR from ash-nazg. |
There are several small fixes, and I'd like to discuss about these changes (and improve it if necessary) before some of them are applied.
line 400: I suppose that it is not clear about what does "ignore" here mean, so I emphasize its motivation.
line 500 and related: I moved one note after the
Attributessection ofBloband another note duplicated in two places just below thetypeattribute definition since the two notes are bothtype-related.For the duplicated note, I deleted its appearance in two other algorithm descriptions because this note addresses what does "parsable MIME type" mean, while the two algorithms don't refer to that particular definition. So I think it is more proper to put it under
typeattribute definition (in which "parsable MIME type" is referred).Also, I rewrote this note in a more readable form as I suppose.
line 520:
uptois a typo as I suppose.line 610: I rewrote description of
close()a more readable form as I suppose.