[css-text-3] Clean up hyphenation section. #3434

Author: fantasai

css-text-3/Overview.bs

@@ -2421,36 +2421,40 @@ Line Breaking Details</h3>
     Hyphenation: the 'hyphens' property</h3>
 
     <p><dfn id=hyphenate lt="hyphenation|hyphenate">Hyphenation</dfn>
-      allows the controlled splitting of words
+      is the controlled splitting of words
+      where they usually would not be allowed to break
       to improve the layout of paragraphs,
-      typically splitting words at syllabic or morphemic boundaries
+      typically splitting words at syllabic or morphemic boundaries,
       and visually indicating the split (usually by inserting a hyphen, U+2010).
       In some cases, hyphenation may also alter the spelling of a word.
       Regardless, hyphenation is a rendering effect only:
       it must have no effect on the underlying document content
       or on text selection or searching.
 
-    <p>Hyphenation occurs when the line breaks at a valid <dfn>hyphenation opportunity</dfn>,
-      which creates a <a>soft wrap opportunity</a> within the word
-      where a visual indication of the split is made when actually wrapping,
-      as discussed above.
-      In CSS it is controlled with the 'hyphens' property.
-      CSS Text Level 3 does not define the exact rules for hyphenation,
-      however UAs are strongly encouraged to optimize their line-breaking implementation
-      to choose good break points and appropriate hyphenation points.
-      Hyphenation opportunities <em>are</em> considered when calculating
-      <a lt="min-content size">min-content intrinsic sizes</a>.
-    <!-- This is because it allows tables to hyphenate instead of overflowing,
-         which is particularly important in long-word languages like German.
-         https://bugzilla.mozilla.org/show_bug.cgi?id=418975 -->
+    <p>Hyphenation occurs when the line breaks at a valid
+      <dfn>hyphenation opportunity</dfn>,
+      which is a type of <a>soft wrap opportunity</a>
+      that exists within a word where <a>hyphenation</a> is allowed.
+      In CSS <a>hyphenation opportunities</a> are controlled
+      with the 'hyphens' property.
+      CSS Text Level 3 does not define the exact rules for <a>hyphenation</a>;
+      however UAs are strongly encouraged
+      to optimize their choice of break points
+      and to chose language-appropriate hyphenation points.
 
       Note: The [=soft wrap opportunity=] introduced by
       the U+002D HYPHEN-MINUS character
       or the U+2010 HYPHEN character
       is not a [=hyphenation opportunity=],
-      as no visual indication of the split is created <em>when wrapping</em>:
+      as no visual indication of the split is <em>created</em> when wrapping:
       these characters are visible whether the line is wrapped at that point or not.
 
+      Hyphenation opportunities <em>are</em> considered when calculating
+      <a lt="min-content size">min-content intrinsic sizes</a>.
+    <!-- This is because it allows tables to hyphenate instead of overflowing,
+         which is particularly important in long-word languages like German.
+         https://bugzilla.mozilla.org/show_bug.cgi?id=418975 -->
+
     <pre class="propdef">
     Name: hyphens
     Value: none | manual | auto
@@ -2463,7 +2467,7 @@ Line Breaking Details</h3>
 
     </pre>
 
-    <p>This property controls whether hyphenation is allowed to create more
+    <p>This property controls whether <a>hyphenation</a> is allowed to create more
       <a>soft wrap opportunities</a> within a line of text.
       Values have the following meanings: