[css-text-3] Make commentary on hyphenation stop heuristics more generic. #3927

Author: fantasai

css-text-3/Overview.bs

@@ -3723,13 +3723,6 @@ Line Breaking Details</h3>
             hyphens/hyphens-span-002.html
             hyphens/hyphens-auto-and-contenteditable-crash.html
           </wpt>
-
-          Note: In some languages
-          (such as English but not German),
-          it may be appropriate to avoid having hyphenation opportunities in mixed case words,
-          as those may indicate proper nouns.
-          This type of heuristic is however not mandated by this specification,
-          as it is up to the User Agent and its language-specific hyphenation resource.
     </dl>
 
     <p>Correct automatic hyphenation requires a hyphenation resource
@@ -3742,6 +3735,21 @@ Line Breaking Details</h3>
         hyphens/hyphens-auto-001.html
       </wpt>
 
+    <p class="advisement">
+      Authors should correctly tag their content’s <a lt="content language">language</a>
+      (e.g. using the HTML <code>lang</code> attribute
+      or XML <code>xml:lang</code> attribute)
+      in order to obtain correct automatic hyphenation.
+
+      The UA may use language-tailored heuristics
+      to exclude certain words
+      from automatic hyphenation.
+      For example, a UA might try to avoid hyphenation in proper nouns
+      by excluding words matching certain capitalization and punctuation patterns.
+      Such heuristics are not defined by this specification.
+      (Note that such heuristics will need to vary by language:
+      English and German, for example, have very different capitalization conventions.)
+
       <p>For the purpose of the 'hyphens' property,
       what constitutes a “word” is UA-dependent.
       However, inline element boundaries
@@ -3755,12 +3763,6 @@ Line Breaking Details</h3>
         hyphens/hyphens-out-of-flow-002.html
       </wpt>
 
-    <p class="advisement">
-      Authors should correctly tag their content’s <a lt="content language">language</a>
-      (e.g. using the HTML <code>lang</code> attribute
-      or XML <code>xml:lang</code> attribute)
-      in order to obtain correct automatic hyphenation.
-
       Any glyph(s) shown due to hyphenation
       at a [=hyphenation opportunity=] created by a conditional hyphen character (such as U+00AD SOFT HYPHEN)
       are represented by that character