diff --git a/index.bs b/index.bs index dc54d79..0cb9d49 100644 --- a/index.bs +++ b/index.bs @@ -139,12 +139,31 @@ provided users can [[design-principles#consent|meaningfully consent]]. ## Honesty ## {#honesty} -A user agent is responsible to explain to its user what's going on, -in terms that user is likely to be able to understand. -These explanations should happen at appropriate times and frequencies, -so that they actually help the user understand -instead of interrupting and distracting the user. - +A user agent must mediate between the Web and its user, +explaining what is happening in a form the user can understand. + +A user agent may use multiple approaches for explanations, including +text, permission prompts, indicators, previews, and other interface elements. +Consider the placement of these elements and whether anything needs emphasis. +See, for example, [Privacy Indicator Requirements](https://www.w3.org/TR/mediacapture-streams/#privacy-indicator-requirements) +Some specifications, like +the [[mediacapture-streams#privacy-indicator-requirements|Privacy Indicator Requirements]] +in the [[mediacapture-streams inline]] specification, +require user agents to explain some specific kinds of website behavior, +but user agents should also use the same techniques when users need to know +about other behavior, even if a specification doesn't specifically call out that behavior. + +An honest user agent actively works to present the truth to its user. +It doesn't just avoid lies. +Its explanations +should clearly represent the current state and likely consequences, +avoid euphemism or ambiguity, +and make it obvious when sensitive activity is occurring. +For example, the user agent might show a clear indicator while audio or video is being captured. + +The user agent should choose when and how often to show these explanations, +so explanations arrive when helpful and inform rather than distract. +The user agent should ensure the user can control if and when they make a decision. ## Loyalty ## {#loyalty}