Merge pull request #2515 from w3c/fix/dir-label

mattgarrish · web-flow · commit 99d2e656fa03 · 2023-01-12T10:38:15.000-04:00
Mark the rtl dir value under-implemented
diff --git a/epub33/core/index.html b/epub33/core/index.html
@@ -3206,7 +3206,15 @@ <h3>Shared attributes</h3>
 					elements).</p>
 
 				<section id="attrdef-dir">
-					<h4>The <code>dir</code> attribute</h4>
+					<h4>The <code>dir</code> attribute (under-implemented)</h4>
+
+					<div class="note">
+						<p>The <code>dir</code> attribute is marked <a href="#under-implemented">under-implemented</a>
+							as [=reading systems=] often only support a single default directionality for text display.
+							[=EPUB creators=] are still strongly encouraged to set the proper directionality of text
+							values in the [=package document=] to ensure proper rendering once this situation
+							improves.</p>
+					</div>
 
 					<p
 						data-tests="#pkg-dir_creator-rtl,#pkg-dir_rtl-root-ltr,#pkg-dir_rtl-root-unset,#pkg-dir_unset-root-rtl,#pkg-dir_unset-root-unset,#pkg-dir-auto_root-rtl"
@@ -3222,8 +3230,8 @@ <h4>The <code>dir</code> attribute</h4>
 							[[bidi]].</li>
 					</ul>
 
-					<p data-tests="#pkg-dir-auto_root-rtl,#pkg-dir-auto_root-unset">[=Reading systems=] will assume the
-						value <code>auto</code> when [=EPUB creators=] omit the attribute or use an invalid value.</p>
+					<p data-tests="#pkg-dir-auto_root-rtl,#pkg-dir-auto_root-unset">Reading systems will assume the
+						value <code>auto</code> when EPUB creators omit the attribute or use an invalid value.</p>
 
 					<div class="note">
 						<p>The base direction specified in the <code>dir</code> attribute does not affect the ordering
@@ -11777,6 +11785,9 @@ <h3>Substantive changes since <a href="https://www.w3.org/TR/2022/CR-epub-33-202
 						Recommendation</a></h3>
 
 				<ul>
+					<li>11-Jan-2023: Marked the <code>dir</code> attribute under-implemented due to lack of support in
+						reading systems. See <a href="https://github.com/w3c/epub-specs/pull/2515">pull request
+						2515</a>.</li>
 					<li>09-Jan-2023: Fixed incorrect OPUS media type. See <a
 							href="https://github.com/w3c/epub-specs/issues/2516">issue 2516</a>.</li>
 					<li>05-Jan-2023: Removed the precedence rules for linked records as reading systems do not support
diff --git a/epub33/rs/index.html b/epub33/rs/index.html
@@ -777,6 +777,16 @@ <h4>Base direction</h4>
 					the base direction is <code>auto</code>, in which case reading systems MUST determine the text's
 					direction by applying the Unicode Bidi Algorithm, beginning with <a data-cite="bidi#P2">Rule P2</a>
 					of [[bidi]].</p>
+
+				<div class="note">
+					<p>Although <a data-cite="epub-33#attrdef-dir">setting the directionality of package document
+							metadata</a> is marked as <a data-cite="epub-33#under-implemented">under-implemented</a> in
+						[[epub-33]], reading system with an international audience, or that claim support for
+						international content, are strongly advised to implement this feature when exposing that
+						metadata to users. Ignoring the directionality of text can cause readability issues.</p>
+					<p>The under-implemented label will be removed from [[epub-33]] when the necessary baseline of
+						support in reading systems has been achieved.</p>
+				</div>
 			</section>
 
 			<section id="sec-pkg-doc-pub-identifiers">
@@ -2487,18 +2497,8 @@ <h3>Recommendations</h3>
 		<section id="app-unsupported" class="appendix">
 			<h2>Unsupported features</h2>
 
-			<p>For features marked as unsupported, [=reading systems=]:</p>
-
-			<ul class="conformance-list">
-				<li>
-					<p id="confreq-rs-under-implemented">SHOULD support <a data-cite="epub-33#under-implemented"
-							>under-implemented features</a> [[epub-33]] as described.</p>
-				</li>
-				<li>
-					<p id="confreq-rs-deprecated">MAY support <a data-cite="epub-33#deprecated">deprecated features</a>
-						[[epub-33]].</p>
-				</li>
-			</ul>
+			<p id="confreq-rs-deprecated">[=reading systems=] MAY support <a data-cite="epub-33#deprecated">deprecated
+					features</a> [[epub-33]].</p>
 
 			<div class="note">
 				<p>Developers should consider the unlikelihood of encountering content with deprecated features before
@@ -2697,6 +2697,11 @@ <h3>Substantive changes since <a href="https://www.w3.org/TR/2022/CR-epub-rs-33-
 						Recommendation</a></h3>
 
 				<ul>
+					<li>11-Jan-2023: Added note advising reading system developers to support package metadata
+						directionality even though marked as under-implemented for authoring. See <a
+							href="https://github.com/w3c/epub-specs/pull/2515">pull request 2515</a>.</li>
+					<li>11-Jan-2023: Removed support description for under-implemented features. See <a
+							href="https://github.com/w3c/epub-specs/pull/2515">pull request 2515</a>.</li>
 					<li>06-Jan-2023: Reduced the requirement to support prefixed CSS properties to a recommendation. See
 							<a href="https://github.com/w3c/epub-specs/pull/2514">pull request 2514</a>.</li>
 					<li>06-Jan-2023: Reduced the requirement to use alternative text for non-text elements in the
