Skip to content

Conversation

csarven
Copy link
Member

@csarven csarven commented Sep 17, 2025

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

index.bs Outdated
Comment on lines 29 to 31
* **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.
Copy link
Contributor

@marcoscaceres marcoscaceres Sep 17, 2025

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:

Suggested change
* **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.

Copy link
Member Author

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.

Copy link
Contributor

Choose a reason for hiding this comment

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

What about "technical writers"?

Copy link
Member Author

@csarven csarven Oct 2, 2025

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.

Copy link
Contributor

@jyasskin jyasskin Oct 2, 2025

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.

Copy link
Contributor

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 🍑.

Copy link
Member Author

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.

Copy link
Member Author

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>
@csarven
Copy link
Member Author

csarven commented Oct 2, 2025

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

@marcoscaceres marcoscaceres left a comment

Choose a reason for hiding this comment

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

looks good

@csarven csarven merged commit 698bc20 into w3ctag:main Oct 16, 2025
1 check passed
github-actions bot added a commit that referenced this pull request Oct 16, 2025
SHA: 698bc20
Reason: push, by csarven

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

State the intended audience of the document

3 participants