diff --git a/index.bs b/index.bs index dc54d79..5fc2997 100644 --- a/index.bs +++ b/index.bs @@ -139,12 +139,33 @@ 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. + +A quintessential example is user agents indicating if a website was served over an encrypted connection. +This has evolved over time, from insecure sites being shown with a broken lock icon, +to some user agents explicitly including the text "not secure" in the URL bar. + +Specifications, like the [[mediacapture-streams inline]], include +[[mediacapture-streams#privacy-indicator-requirements|Privacy Indicator Requirements]] +that 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. + +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}