Minor spec changes based on TAG feedback#150
Conversation
| 1. Initiate the download of the on-device speech recognition language for <var>lang</var>. | ||
| <p class=note> | ||
| Note: The user agent can prompt the user for explicit permission to download the on-device speech recognition language pack. | ||
| Note: The user agent MAY prompt the user for explicit permission to download the on-device speech recognition language pack. |
There was a problem hiding this comment.
You're not supposed to use MAY inside a non-normative paragraph like a note, and in fact you should turn on Complain About: accidental-2119 in the bikeshed metadata to flag when you do it by accident (as suggested in #147). Instead, you'll need to specify the actions the UA must take if the user denies permission, similar to "If the user explicitly or implicitly signals that they do not want to start the download" in https://pr-preview.s3.amazonaws.com/webmachinelearning/writing-assistance-apis/pull/47.html#step-download-user-interface.
There was a problem hiding this comment.
I had it enabled in another PR but forgot to merge, this is now done (with another lint).
| 1. Initiate the download of the on-device speech recognition language for <var>lang</var>. | ||
| <p class=note> | ||
| Note: The user agent can prompt the user for explicit permission to download the on-device speech recognition language pack. | ||
| Note: The user agent MAY prompt the user for explicit permission to download the on-device speech recognition language pack. |
There was a problem hiding this comment.
I had it enabled in another PR but forgot to merge, this is now done (with another lint).
4 participants
This CL contains the following changes based on TAG feedback (w3ctag/design-reviews#1038 (comment)):
Preview | Diff