transparency section

[npdoty]

addresses #263

principles for providing transparency, plain and machine-readable, distinguishable apis

citations to Adding Permissions guide, Unsanctioned Tracking, Fingerprinting

note with links to permissions workshops

---

Preview | Diff

[npdoty]

In a few cases here, the text uses passive voice, which was helpful in that it was broad, but reviewers point out that its vague.

I think what we typically mean is: sites should provide, and user agents should help present and consume, information to people

But there are some cases where it might go beyond that typical case. A user agent might collect or share information and should itself provide transparency. Other actors may collect or share information outside of the site-browser interaction. Should we exclude these from the scope of the document? Or just talk about the typical case at the top, and then add a sentence or two about other cases where different actors need to cooperate in providing transparency?

[npdoty]

Maybe "actors who are processing data (typically, sites) should provide, and user agents should help present and consume,"

[jyasskin]

We'll merge this once @pes10k and @jyasskin have re-read the text and approved the PR.