Skip to content
26 changes: 20 additions & 6 deletions index.bs
Original file line number Diff line number Diff line change
Expand Up @@ -139,12 +139,26 @@ 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)
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
See, for example, [Privacy Indicator Requirements](https://www.w3.org/TR/mediacapture-streams/#privacy-indicator-requirements)

of the <cite>Media Capture and Streams</cite> specification.

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.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Repeating my comment from above, this sentence points out the same indicator behavior as the "Privacy Indicator Requirements" in mediacapture. We should keep just one of them, and perhaps replace the other with a different example of UA honesty.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe the example could be that the UA presents the risks associated with a lack of encryption (on http vs https schemed URLs). Or that it makes the privacy benefits and drawbacks of private browsing modes clear.


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}

Expand Down