Skip to content
19 changes: 14 additions & 5 deletions index.bs
Original file line number Diff line number Diff line change
Expand Up @@ -139,12 +139,21 @@ 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, placement and emphasis, and other cues.
Copy link
Contributor

Choose a reason for hiding this comment

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

Can you link to examples of each of these? "Indicators" and "previews", especially, seem to need more context than most readers will have.

"Placement and emphasis" doesn't seem like an approach for an explanation, but rather how to display some other approach. It could belong in a separate sentence?


These explanations serve the duty of honesty:
they should truthfully represent the current state and likely consequences,
avoid euphemism or ambiguity,
and make it obvious when sensitive activity is occurring
(e.g., a clear indicator while audio/video capture is active).

The user agent should choose when and how often to show these explanations,
so explanations arrive when helpful and inform rather than distract,
helping the user make informed choices.

## Loyalty ## {#loyalty}

Expand Down