Add Audience section (#25)

SHA: 698bc20
Reason: push, by csarven

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: csarven

index.html

@@ -8,7 +8,7 @@
   <meta content="Bikeshed version 3f621ba99, updated Mon Jul 28 15:38:36 2025 -0700" name="generator">
   <link href="https://w3ctag.github.io/user-agents" rel="canonical">
   <link href="https://www.w3.org/2008/site/images/favicon.ico" rel="icon">
-  <meta content="854d53ce5c7bc1c667a990212ce8787faae3ec0b" name="revision">
+  <meta content="698bc2005806254c5d494773510305ee0b035822" name="revision">
   <meta content="dark light" name="color-scheme">
   <link href="https://www.w3.org/StyleSheets/TR/2021/dark.css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css">
 <style>/* Boilerplate: style-autolinks */
@@ -574,7 +574,7 @@
 </p>
    <h1 class="p-name no-ref" id="title">Web User Agents</h1>
    <p id="w3c-state"><a href="https://www.w3.org/standards/types/#ED">Editor’s Draft</a>,
-    <time class="dt-updated" datetime="2025-09-17">17 September 2025</time></p>
+    <time class="dt-updated" datetime="2025-10-16">16 October 2025</time></p>
    <details open>
     <summary>More details about this document</summary>
     <div data-fill-with="spec-metadata">
@@ -643,15 +643,16 @@ <h2 class="no-num no-toc no-ref heading settled" id="sotd"><span class="content"
   <nav data-fill-with="table-of-contents" id="toc">
    <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
    <ol class="toc" role="directory">
-    <li><a href="#what"><span class="secno">1</span> <span class="content">What is a web user agent</span></a>
+    <li><a href="#audience"><span class="secno">1</span> <span class="content">Audience</span></a>
+    <li><a href="#what"><span class="secno">2</span> <span class="content">What is a web user agent</span></a>
     <li>
-     <a href="#duties"><span class="secno">2</span> <span class="content">Duties of user agents</span></a>
+     <a href="#duties"><span class="secno">3</span> <span class="content">Duties of user agents</span></a>
      <ol class="toc">
-      <li><a href="#protection"><span class="secno">2.1</span> <span class="content">Protection</span></a>
-      <li><a href="#honesty"><span class="secno">2.2</span> <span class="content">Honesty</span></a>
-      <li><a href="#loyalty"><span class="secno">2.3</span> <span class="content">Loyalty</span></a>
+      <li><a href="#protection"><span class="secno">3.1</span> <span class="content">Protection</span></a>
+      <li><a href="#honesty"><span class="secno">3.2</span> <span class="content">Honesty</span></a>
+      <li><a href="#loyalty"><span class="secno">3.3</span> <span class="content">Loyalty</span></a>
      </ol>
-    <li><a href="#acknowledgements"><span class="secno">3</span> <span class="content">Acknowledgements</span></a>
+    <li><a href="#acknowledgements"><span class="secno">4</span> <span class="content">Acknowledgements</span></a>
     <li>
      <a href="#index"><span class="secno"></span> <span class="content">Index</span></a>
      <ol class="toc">
@@ -667,7 +668,19 @@ <h2 class="no-num no-toc no-ref" id="contents">Table of Contents</h2>
    </ol>
   </nav>
   <main>
-   <h2 class="heading settled" data-level="1" id="what"><span class="secno">1. </span><span class="content">What is a web user agent</span><a class="self-link" href="#what"></a></h2>
+   <h2 class="heading settled" data-level="1" id="audience"><span class="secno">1. </span><span class="content">Audience</span><a class="self-link" href="#audience"></a></h2>
+   <p>This document is intended for:</p>
+   <ul>
+    <li data-md>
+     <p><strong>Technical authors</strong> who want to reuse or reference these concepts in their own specifications or documentation.</p>
+    <li data-md>
+     <p><strong>User agent developers</strong> who want to align implementations with design and privacy principles that prioritize their users.</p>
+    <li data-md>
+     <p><strong>Web developers</strong> who want to understand why user agents prioritize user privacy and security over other constituencies, including developer convenience.</p>
+    <li data-md>
+     <p><strong>Regulators and policymakers</strong> who seek to understand the duties, principles, and expectations guiding user agent behavior.</p>
+   </ul>
+   <h2 class="heading settled" data-level="2" id="what"><span class="secno">2. </span><span class="content">What is a web user agent</span><a class="self-link" href="#what"></a></h2>
    <p>A <dfn class="dfn-paneled" data-dfn-type="dfn" data-export data-lt="user agent|web user agent" id="user-agent">web user agent</dfn> is
 any software entity that interacts with websites outside the entity itself,
 on behalf of its user,
@@ -689,13 +702,13 @@ <h2 class="heading settled" data-level="1" id="what"><span class="secno">1. </sp
 user agents choose which specifications to implement in order to best serve their users,
 and they implement proprietary user interfaces and other behavior
 around the specifications they do implement.</p>
-   <h2 class="heading settled" data-level="2" id="duties"><span class="secno">2. </span><span class="content">Duties of user agents</span><a class="self-link" href="#duties"></a></h2>
+   <h2 class="heading settled" data-level="3" id="duties"><span class="secno">3. </span><span class="content">Duties of user agents</span><a class="self-link" href="#duties"></a></h2>
    <p>Each user agent serves its user (<a data-biblio-display="inline" data-link-type="biblio" href="https://www.rfc-editor.org/rfc/rfc8890"><cite>The Internet is for End Users</cite></a>),
 not any of the other constituencies.
 A user agent owes its user various duties,
 which should be established through collective discussions
 and embodied in the various standards that user agents implement.</p>
-   <h3 class="heading settled" data-level="2.1" id="protection"><span class="secno">2.1. </span><span class="content">Protection</span><a class="self-link" href="#protection"></a></h3>
+   <h3 class="heading settled" data-level="3.1" id="protection"><span class="secno">3.1. </span><span class="content">Protection</span><a class="self-link" href="#protection"></a></h3>
    <p><a href="https://w3ctag.github.io/design-principles/#safe-to-browse">It should be safe to visit a web page.</a>
 Visiting a page must not by itself
 let the page change the user’s computer or environment,
@@ -751,13 +764,13 @@ <h3 class="heading settled" data-level="2.1" id="protection"><span class="secno"
 APIs like <a data-biblio-display="inline" data-link-type="biblio" href="https://wicg.github.io/file-system-access/"><cite>File System Access</cite></a> don’t violate this duty,
 provided users can <a href="https://w3ctag.github.io/design-principles/#consent">meaningfully consent</a>.</p>
    </div>
-   <h3 class="heading settled" data-level="2.2" id="honesty"><span class="secno">2.2. </span><span class="content">Honesty</span><a class="self-link" href="#honesty"></a></h3>
+   <h3 class="heading settled" data-level="3.2" id="honesty"><span class="secno">3.2. </span><span class="content">Honesty</span><a class="self-link" href="#honesty"></a></h3>
    <p>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.</p>
-   <h3 class="heading settled" data-level="2.3" id="loyalty"><span class="secno">2.3. </span><span class="content">Loyalty</span><a class="self-link" href="#loyalty"></a></h3>
+   <h3 class="heading settled" data-level="3.3" id="loyalty"><span class="secno">3.3. </span><span class="content">Loyalty</span><a class="self-link" href="#loyalty"></a></h3>
    <p>A user agent must serve its user’s interests
 over its implementer’s interests
 and over the interests of any other party.</p>
@@ -768,7 +781,7 @@ <h3 class="heading settled" data-level="2.3" id="loyalty"><span class="secno">2.
 make a credible commitment to a page in order to get that page’s services,
 and it’s not disloyal to maintain that commitment after getting the services.</p>
    <section class="non-normative">
-    <h2 class="heading settled" data-level="3" id="acknowledgements"><span class="secno">3. </span><span class="content">Acknowledgements</span><a class="self-link" href="#acknowledgements"></a></h2>
+    <h2 class="heading settled" data-level="4" id="acknowledgements"><span class="secno">4. </span><span class="content">Acknowledgements</span><a class="self-link" href="#acknowledgements"></a></h2>
     <p>Thanks to the <a data-biblio-display="inline" data-link-type="biblio" href="https://infra.spec.whatwg.org/"><cite>Infra Standard</cite></a>
 for an earlier definition of User Agents
 and to <a data-biblio-display="inline" data-link-type="biblio" href="https://w3ctag.github.io/privacy-principles/"><cite>Privacy Principles</cite></a> for the initial version of these duties.</p>
@@ -778,8 +791,8 @@ <h2 class="heading settled" data-level="3" id="acknowledgements"><span class="se
   <h2 class="no-num no-ref heading settled" id="index"><span class="content">Index</span><a class="self-link" href="#index"></a></h2>
   <h3 class="no-num no-ref heading settled" id="index-defined-here"><span class="content">Terms defined by this specification</span><a class="self-link" href="#index-defined-here"></a></h3>
   <ul class="index">
-   <li><a href="#user-agent">user agent</a><span>, in § 1</span>
-   <li><a href="#user-agent">web user agent</a><span>, in § 1</span>
+   <li><a href="#user-agent">user agent</a><span>, in § 2</span>
+   <li><a href="#user-agent">web user agent</a><span>, in § 2</span>
   </ul>
   <h3 class="no-num no-ref heading settled" id="index-defined-elsewhere"><span class="content">Terms defined by reference</span><a class="self-link" href="#index-defined-elsewhere"></a></h3>
   <ul class="index">
@@ -1025,11 +1038,11 @@ <h3 class="no-num no-ref heading settled" id="informative"><span class="content"
 "use strict";
 {
 let dfnPanelData = {
-"0497de86": {"dfnID":"0497de86","dfnText":"@font-face","external":true,"refSections":[{"refs":[{"id":"ref-for-at-font-face-rule"}],"title":"2.1. Protection"}],"url":"https://drafts.csswg.org/css-fonts-5/#at-font-face-rule"},
-"086e3aff": {"dfnID":"086e3aff","dfnText":"origin","external":true,"refSections":[{"refs":[{"id":"ref-for-concept-origin"}],"title":"2.1. Protection"}],"url":"https://html.spec.whatwg.org/multipage/browsers.html#concept-origin"},
-"6d60ab67": {"dfnID":"6d60ab67","dfnText":"File Upload","external":true,"refSections":[{"refs":[{"id":"ref-for-file-upload-state-(type%3Dfile)"}],"title":"2.1. Protection"}],"url":"https://html.spec.whatwg.org/multipage/input.html#file-upload-state-(type%3Dfile)"},
-"959ad97b": {"dfnID":"959ad97b","dfnText":"origin","external":true,"refSections":[{"refs":[{"id":"ref-for-concept-url-origin"}],"title":"2.1. Protection"}],"url":"https://url.spec.whatwg.org/#concept-url-origin"},
-"user-agent": {"dfnID":"user-agent","dfnText":"web user agent","external":false,"refSections":[{"refs":[{"id":"ref-for-user-agent"}],"title":"1. What is a web user agent"}],"url":"#user-agent"},
+"0497de86": {"dfnID":"0497de86","dfnText":"@font-face","external":true,"refSections":[{"refs":[{"id":"ref-for-at-font-face-rule"}],"title":"3.1. Protection"}],"url":"https://drafts.csswg.org/css-fonts-5/#at-font-face-rule"},
+"086e3aff": {"dfnID":"086e3aff","dfnText":"origin","external":true,"refSections":[{"refs":[{"id":"ref-for-concept-origin"}],"title":"3.1. Protection"}],"url":"https://html.spec.whatwg.org/multipage/browsers.html#concept-origin"},
+"6d60ab67": {"dfnID":"6d60ab67","dfnText":"File Upload","external":true,"refSections":[{"refs":[{"id":"ref-for-file-upload-state-(type%3Dfile)"}],"title":"3.1. Protection"}],"url":"https://html.spec.whatwg.org/multipage/input.html#file-upload-state-(type%3Dfile)"},
+"959ad97b": {"dfnID":"959ad97b","dfnText":"origin","external":true,"refSections":[{"refs":[{"id":"ref-for-concept-url-origin"}],"title":"3.1. Protection"}],"url":"https://url.spec.whatwg.org/#concept-url-origin"},
+"user-agent": {"dfnID":"user-agent","dfnText":"web user agent","external":false,"refSections":[{"refs":[{"id":"ref-for-user-agent"}],"title":"2. What is a web user agent"}],"url":"#user-agent"},
 };
 
 document.addEventListener("DOMContentLoaded", ()=>{