From baf4501ab72d873e795d016cee20a2bd00c68ba5 Mon Sep 17 00:00:00 2001
From: Anne van Kesteren <annevk@annevk.nl>
Date: Thu, 21 Oct 2021 13:43:49 +0200
Subject: [PATCH 1/2] Editorial: clarify URL validity

Closes #595.
---
 url.bs | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/url.bs b/url.bs
index 8ad40e2d..bb15d44a 100644
--- a/url.bs
+++ b/url.bs
@@ -1201,7 +1201,7 @@ unified model would be, please file an issue.
 
 <ul>
  <li><p>The <a>URL parser</a> takes an arbitrary <a>scalar value string</a> and returns either
- failure or a <a for=/>URL</a>.
+ failure or a <a for=/>URL</a>. It might also record zero or more <a>validation errors</a>.
 
  <li><p>A <a for=/>URL</a> can be seen as the in-memory representation.
 
@@ -1211,7 +1211,9 @@ unified model would be, please file an issue.
 
  <li><p>The <a>URL serializer</a> takes a <a for=/>URL</a> and returns an <a>ASCII string</a>. (If
  that string is then <a lt="URL parser">parsed</a>, the result will <a for=url>equal</a> the <a
- for=/>URL</a> that was <a lt="URL serializer">serialized</a>.)
+ for=/>URL</a> that was <a lt="URL serializer">serialized</a>.) The output of the
+ <a>URL serializer</a> is not always a <a>valid URL string</a>. I.e., not all <a for=/>URLs</a> are
+ valid.
 </ul>
 
 <div class=example id=example-url-parsing>
@@ -1311,6 +1313,11 @@ unified model would be, please file an issue.
    <td>
    <td>✅
    <td><code>https://example.org//</code>
+  <tr>
+   <td><code>https://example.com/[]?[]#[]</code>
+   <td>
+   <td>❌
+   <td><code>https://example.com/[]?[]#[]</code>
  </table>
 
  <p>The base and output <a lt="URL record">URL</a> are represented in

From c3ade5073d419894244b2d7ad6222cc3dd31b6b1 Mon Sep 17 00:00:00 2001
From: Anne van Kesteren <annevk@annevk.nl>
Date: Fri, 9 Dec 2022 11:26:24 +0100
Subject: [PATCH 2/2] address nit (don't add an issue pointer for now as
 there's no clear proposal or consensus)

---
 url.bs | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/url.bs b/url.bs
index bb15d44a..c246c736 100644
--- a/url.bs
+++ b/url.bs
@@ -1212,8 +1212,7 @@ unified model would be, please file an issue.
  <li><p>The <a>URL serializer</a> takes a <a for=/>URL</a> and returns an <a>ASCII string</a>. (If
  that string is then <a lt="URL parser">parsed</a>, the result will <a for=url>equal</a> the <a
  for=/>URL</a> that was <a lt="URL serializer">serialized</a>.) The output of the
- <a>URL serializer</a> is not always a <a>valid URL string</a>. I.e., not all <a for=/>URLs</a> are
- valid.
+ <a>URL serializer</a> is not always a <a>valid URL string</a>.
 </ul>
 
 <div class=example id=example-url-parsing>