Re: [whatwg/url] Editorial: adopt Infra for URLSearchParams (PR #717)

@andreubotella commented on this pull request.



> @@ -2853,7 +2853,7 @@ handled with care to prevent spoofing:
 <h2 id="application/x-www-form-urlencoded"><code>application/x-www-form-urlencoded</code></h2>
 
 <p>The <dfn export id=concept-urlencoded><code>application/x-www-form-urlencoded</code></dfn> format
-provides a way to encode name-value pairs.
+provides a way to encode name-value <a for=/>tuples</a>.

Since this is a general description, "name-value pair" works, if we take "pair" as the common term rather than the now-removed infra definition. Otherwise, it should probably be "tuples consisting of a name and a value" as below.

> @@ -3345,20 +3345,19 @@ console.log(url.searchParams.get('b')); // "~"</code></pre>
 
 <ol>
  <li>
-  <p>If <var>init</var> is a <a>sequence</a>, then <a for=list>for each</a> <var>pair</var> in
+  <p>If <var>init</var> is a <a>sequence</a>, then <a for=list>for each</a> <var>tuple</var> of

The variable name could still be "pair".

> @@ -3411,42 +3410,42 @@ method steps are:
 <p>The <dfn method for=URLSearchParams><code>delete(<var>name</var>)</code></dfn> method steps are:
 
 <ol>
- <li><p>Remove all name-value pairs whose name is <var>name</var> from
- <a for=URLSearchParams>list</a>.
+ <li><p><a for=list>Remove</a> all <a for=/>tuples</a> whose name is <var>name</var> from

"whose first element"? And similarly below.

-- 
Reply to this email directly or view it on GitHub:
https://github.com/whatwg/url/pull/717#pullrequestreview-1190641472
You are receiving this because you are subscribed to this thread.

Message ID: <whatwg/url/pull/717/review/1190641472@github.com>