From 1eeaf00f2e294a6d95ee3ea82f54561728d773ad Mon Sep 17 00:00:00 2001
From: Luke Warlow <lwarlow@igalia.com>
Date: Mon, 22 Apr 2024 16:44:55 +0100
Subject: [PATCH] Address comment

---
 dom.bs | 29 +++++++++++++++--------------
 1 file changed, 15 insertions(+), 14 deletions(-)

diff --git a/dom.bs b/dom.bs
index 54f1a6d4..6296349a 100644
--- a/dom.bs
+++ b/dom.bs
@@ -4334,7 +4334,7 @@ do as defined below, switching on the interface <var>node</var> <a>implements</a
  <dd><p><a>String replace all</a> with <var>value</var> within <var>node</var>.
 
  <dt>{{Attr}}
- <dd><p><a>Set an existing attribute value</a> with <var>node</var>, <var>value</var>.
+ <dd><p><a>Set an existing attribute value</a> with <var>node</var> and <var>value</var>.
 
  <dt>{{CharacterData}}
  <dd><p><a>Replace data</a> with node <var>node</var>, offset 0, count <var>node</var>'s
@@ -6376,7 +6376,7 @@ given a <var>document</var>, <var>localName</var>, <var>namespace</var>, and opt
 <ol>
  <li><p>Let <var>oldValue</var> be <var>attribute</var>'s <a for=Attr>value</a>.</p></li>
 
- <li><p><a>Validate and set attribute value</a> <var>value</var> for <var>attribute</var>, with
+ <li><p><a>Verify and set attribute value</a> <var>value</var> for <var>attribute</var>, with
  <var>attribute</var>'s <a for=Attr>element</a>.
 
  <li><p>If <var>attribute</var>'s <a for=Attr>element</a> <a lt="has an attribute">has</a>
@@ -6393,9 +6393,9 @@ boolean <var>validate</var> (default true), run these steps:
 
 <ol>
  <li>
-  <p>If <var>validate</var>, then:
+  <p>If <var>validate</var> is true, then:
   <ol>
-   <li><p><a>Validate and set attribute value</a>
+   <li><p><a>Verify and set attribute value</a>
    <var>attribute</var>'s <a for="Attr">value</a> for <var>attribute</var> with <var>element</var>.
 
    <li><p>If <var>element</var> <a lt="has an attribute">has</a> an <a>attribute</a>
@@ -6430,7 +6430,7 @@ boolean <var>validate</var> (default true), run these steps:
 <a>attribute</a> <var>oldAttr</var> with an <a>attribute</a> <var>newAttr</var>, run these steps:
 
 <ol>
- <li><p><a>Validate and set attribute value</a> <var>newAttr</var>'s <a for="Attr">value</a> for
+ <li><p><a>Verify and set attribute value</a> <var>newAttr</var>'s <a for="Attr">value</a> for
  <var>newAttr</var> with <var>oldAttr</var>'s <a for=Attr>element</a>.
 
  <li><p><a for=list>Replace</a> <var>oldAttr</var> by <var>newAttr</var> in <var>oldAttr</var>'s
@@ -6446,8 +6446,8 @@ boolean <var>validate</var> (default true), run these steps:
  <a for=Attr>value</a>.
 </ol>
 
-<p>To <dfn id=concept-element-attributes-validate-and-set-value>validate and set attribute value</dfn>
-{{TrustedType}} or a string <var>value</var> for an <a>attribute</a> <var>attribute</var>, with
+<p>To <dfn id=concept-element-attributes-verify-and-set-value>verify and set attribute value</dfn>
+{{TrustedType}} or string <var>value</var> for an <a>attribute</a> <var>attribute</var>, with
 <a for=/>element</a> <var>element</var>:
 
 <ol>
@@ -6507,7 +6507,7 @@ string <var>namespace</var> (default null):</p>
 
 <div algorithm>
 <p>To <dfn export id=concept-element-attributes-set>set an attribute</dfn> given an
-<a for=/>attribute</a> <var>attr</var>, an <a for=/>element</a> <var>element</var>.
+<a for=/>attribute</a> <var>attr</var> and an <a for=/>element</a> <var>element</var>:
 
 <ol>
  <li><p>If <var>attr</var>'s <a for=Attr>element</a> is neither null nor <var>element</var>,
@@ -6542,7 +6542,8 @@ or string <var>namespace</var> (default null):
  <var>namespace</var>, <a for=Attr>namespace prefix</a> is <var>prefix</var>,
  <a for=Attr>local name</a> is <var>localName</var>, <a for=Attr>value</a> is <var>value</var>, and
  <a for=Node>node document</a> is <var>element</var>'s <a for=Node>node document</a>, then
- <a lt="append an attribute">append</a> this <a>attribute</a> to <var>element</var>, and then return.
+ <a lt="append an attribute">append</a> this <a>attribute</a> to <var>element</var>, and then
+ return.
 
  <li><p><a lt="change an attribute">Change</a> <var>attribute</var> to <var>value</var>.
 </ol>
@@ -6871,8 +6872,8 @@ method steps are:
    <li><p>If <var>force</var> is not given or is true, create an <a>attribute</a> whose
    <a for=Attr>local name</a> is <var>qualifiedName</var>, <a for=Attr>value</a> is the empty
    string, and <a for=Node>node document</a> is <a>this</a>'s <a for=Node>node document</a>, then
-   <a lt="append an attribute">append</a> this <a>attribute</a> to <a>this</a>,
-   and then return true.
+   <a lt="append an attribute">append</a> this <a>attribute</a> to <a>this</a>, and then return
+   true.
 
    <li><p>Return false.
   </ol>
@@ -7373,7 +7374,7 @@ null.
 <p>The <dfn attribute for=Attr><code>value</code></dfn> getter steps are to return <a>this</a>'s
 <a for=Attr>value</a>.
 
-<p>To <dfn>set an existing attribute value</dfn>, given an <a>attribute</a> <var>attribute</var>,
+<p>To <dfn>set an existing attribute value</dfn>, given an <a>attribute</a> <var>attribute</var> and
 string <var>value</var>, run these steps:
 
 <ol>
@@ -7383,8 +7384,8 @@ string <var>value</var>, run these steps:
  <li><p>Otherwise, <a lt="change an attribute">change</a> <var>attribute</var> to <var>value</var>.
 </ol>
 
-<p>The {{Attr/value}} setter steps are to <a>set an existing attribute value</a> with <a>this</a>,
-the given value, and "Attr value".
+<p>The {{Attr/value}} setter steps are to <a>set an existing attribute value</a> with <a>this</a>
+and the given value.
 
 <hr>