From 5a4d9a86561204bb82c0809303eb5be8fa170250 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Tim=20D=C3=BCsterhus?= <tim@bastelstu.be>
Date: Mon, 6 Apr 2026 20:50:29 +0200
Subject: [PATCH] uri: Improve explanation for UrlValidationError

---
 reference/uri/uri.whatwg.urlvalidationerror.xml | 7 +++++--
 1 file changed, 5 insertions(+), 2 deletions(-)

diff --git a/reference/uri/uri.whatwg.urlvalidationerror.xml b/reference/uri/uri.whatwg.urlvalidationerror.xml
index bcdc0d403573..a53ca9f4a7a2 100644
--- a/reference/uri/uri.whatwg.urlvalidationerror.xml
+++ b/reference/uri/uri.whatwg.urlvalidationerror.xml
@@ -7,6 +7,8 @@
   <section xml:id="uri-whatwg-urlvalidationerror.intro">
    &reftitle.intro;
    <simpara>
+    Provides details about errors that were detected when parsing a URL with
+    <classname>Uri\WhatWg\Url</classname>.
    </simpara>
   </section>
 
@@ -63,7 +65,7 @@
      <term><varname>type</varname></term>
      <listitem>
       <simpara>
-       A <classname>Uri\WhatWg\UrlValidationErrorType</classname> instance.
+       The type of error.
       </simpara>
      </listitem>
     </varlistentry>
@@ -71,7 +73,8 @@
      <term><varname>failure</varname></term>
      <listitem>
       <simpara>
-       Whether the error refers to a failure, or a soft-error.
+       If &true; the error caused the URL to be rejected as invalid. If &false;
+       the error is a soft error that was automatically corrected during parsing.
       </simpara>
      </listitem>
     </varlistentry>