Rework Honesty section

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}