-
Notifications
You must be signed in to change notification settings - Fork 4
Add Audience section #25
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
Closes w3ctag#13
index.bs
Outdated
* **User agent developers** who want to align implementations with design and privacy principles that prioritize their users. | ||
* **Regulators and policymakers** who need criteria to assess whether user agents fulfill their duties to users. | ||
* **Technical authors** who want to reuse or reference these concepts in their own specifications or documentation. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think the last sentence is overstepping:
* **User agent developers** who want to align implementations with design and privacy principles that prioritize their users. | |
* **Regulators and policymakers** who need criteria to assess whether user agents fulfill their duties to users. | |
* **Technical authors** who want to reuse or reference these concepts in their own specifications or documentation. | |
* ** Editors/Technical writers**, who need to normatively or informatively reference the concept herein in their own specifications or documentation. | |
* **User agent implementers**, who want to align implementations with design and privacy principles as described in the manner described in this document. | |
* **Regulators and policymakers**, who need understand what constitutes a user agent. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
"Technical authors" is intentional. It covers both spec writers as well as anyone generally contributing to specification development. But it also includes anyone that is writing a document (not necessarily a "spec") that needs to refer to these concepts.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
What about "technical writers"?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
That could work too. My interpretation is that "technical authors" is a bit broader and also covers "technical writers". Authors captures spec writers, standards contributors, and generally anyone defining or referencing technical documentation, including writers of docs/guides/manuals for users and other developers. Besides, I think the definition here is adequate.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Either writers or authors works for me. Marcos also made at least two other suggestions in his patch, and it would be good to resolve that too. I don't feel strongly about either, but:
- "in the manner described in this document." is a little vague, though accurate
- I think this document does more than just explain "what constitutes a user agent.": it at least expresses the norms that the technical community has over how they should act. I'm comfortable with this document being full on advice to regulators, but also fine with moderating that.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'm comfortable with this document being full on advice to regulators
I'm not super comfortable... no one us are lawmakers or lawyers and I worry it will come back to bite us in the 🍑.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@jyasskin , ack!
@marcoscaceres , bite us how?
Aside: If there's an argument for including web developers as an audience, there's at least as strong a case for including regulators, since both can benefit from understanding these principles.
To be clear, this document sets technical and ethical duties, not legal obligations. It can serve as a reference for understanding web community expectations but is not intended as binding or advisory law. We can improve it to avoid ambiguity that might lead to misinterpretation.
I'd argue that the TAG/W3C should take this opportunity to rise to the occasion, so to speak.
I've updated the definition based on above to clarify but if that's not aligned with our goal, am completely open to discuss.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I thought "in the manner described in this document" is redundant. It's already implied by the section, and there's nothing else it could refer to.
I really like the proposed "prioritize their users" because it signals the user-centric duty up front. Also aligns with the priority of constituencies.
Co-authored-by: Marcos Cáceres <marcos@marcosc.com>
@jyasskin , I'm content with the current state of this PR but you and others may want to have a final look. |
Co-authored-by: Marcos Cáceres <marcos@marcosc.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
looks good
SHA: 698bc20 Reason: push, by csarven Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Closes #13
Adding this section after the Abstract because it doesn't fit elsewhere at the moment. If we introduce an Introduction section, the contents of this section can be moved there.
Preview | Diff