Re: [compute-pressure] "User notifications" section should be more specific (#194)

While pondering this I realized that a change in one important keyword in this section could make a major difference in how implementers will perceive and approach this recommendation.

@pes10k, what do you think if we'd change "unobtrusive" to "user-visible"? I personally prefer concise guidance because it is more likely to be read (and adhered to) by implementers. Here's how this section would read with this improvement (emphasis mine):

>It is RECOMMENDED that a [user agent](https://www.w3.org/TR/compute-pressure/#dfn-user-agent) show some form of **user-visible** notification that informs the user when a pressure observer is active, as well as provides the user with the means to block the ongoing operation, or simply dismiss the notification.

AFAICT the adjective "unobtrusive" does not have a special meaning in web specs and its dictionary definition reads:
>unobtrusive /ʌnəbˈtruːsɪv/
>adjective
>not conspicuous or attracting attention.

"Unobtrusive" could indeed be interpreted so that a console.log message could suffice which clearly is _not_ an appropriate way to inform users.

OTOH I see "user-visible" appear in a few web specs. While also not a web spec defined concept, it is more concrete and better understood by non-native speakers I believe. If there's a better word for this please let us know!

@pes10k maybe this is the significant change we need in this section for now? Small yet impactful. Thank you for your continued contributions!

(As a bonus, this updated user notifications section could in part also help mitigate the proposed cross-site covert channels attack discussed in #197. Perhaps we could note in the mitigations section that if an implementation detects a long-running script that is using this API we could recommend this user notification to become more prominent akin to unresponsive script warning in some browsers.)

-- 
GitHub Notification of comment by anssiko
Please view or discuss this issue at https://github.com/w3c/compute-pressure/issues/194#issuecomment-1576559972 using your GitHub account


-- 
Sent via github-notify-ml as configured in https://github.com/w3c/github-notify-ml-config

Received on Monday, 5 June 2023 10:47:31 UTC