Merge pull request #2787 from w3c/a11y/issue-2112

Add note about use of URLs in evaluator credential

Author: mattgarrish

epub34/a11y/index.html

@@ -1335,6 +1335,15 @@ <h5>Evaluator credentials</h5>
 							<a href="https://www.w3.org/TR/epub/#subexpression">associated with</a> [[epub-3]] the <a
 								href="#sec-evaluator-name">evaluator's name</a>.</p>
 
+						<div class="note">
+							<p>Although it is possible to use a URL as the value of the
+									<code>a11y:certifierCredential</code> property instead of a human-readable string,
+								this could lead to awkward display of the metadata in some reading systems, vendor
+								bookstores, and library catalogues. To improve the display (e.g., to match the URL and
+								display an icon in its place), the provider of the credential is responsible for
+								ensuring these systems are aware of their URL badge and how to process it.</p>
+						</div>
+
 						<aside class="example" title="Expressing a basic credential">
 							<p>In this example, the <code>refines</code> attribute associates the credential with the
 								certifier.</p>
@@ -1974,6 +1983,9 @@ <h2>Change log</h2>
 				<summary>Substantive changes since <a href="https://w3.org/TR/epub-a11y-11/">EPUB Accessibility
 					1.1</a></summary>
 				<ul>
+					<li>05-Sept-2025: Added a note to the evaluator credential field that while URLs are valid values
+						they will typically require additional processing for display. See <a
+							href="https://github.com/w3c/epub-specs/issues/2112">issue 2112</a>.</li>
 					<li>04-Sept-2025: Added <code>a11y:contactEmail</code> to allow EPUB creators to include a contact
 						email for additional accessibility info and to express concerns. See <a
 							href="https://github.com/w3c/epub-specs/issues/2702">issue 2702</a>.</li>