[DOC-CVS] [doc-en] master: uri: Improve explanation for UrlValidationError (#5472)

Author: Tim Düsterhus (TimWolla)
Committer: GitHub (web-flow)
Pusher: kocsismate
Date: 2026-04-06T21:59:51+02:00

Commit: https://github.com/php/doc-en/commit/b6e9565ba267f4c9a463104ffb0ea45e1a6753b0
Raw diff: https://github.com/php/doc-en/commit/b6e9565ba267f4c9a463104ffb0ea45e1a6753b0.diff

uri: Improve explanation for UrlValidationError (#5472)

Changed paths:
  M  reference/uri/uri.whatwg.urlvalidationerror.xml


Diff:

diff --git a/reference/uri/uri.whatwg.urlvalidationerror.xml b/reference/uri/uri.whatwg.urlvalidationerror.xml
index 0c661b260323..a25ea9858cad 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>