diff --git a/src/docs/text-wrap.mdx b/src/docs/text-wrap.mdx
index 868a3fd8b..3b4e2072a 100644
--- a/src/docs/text-wrap.mdx
+++ b/src/docs/text-wrap.mdx
@@ -111,7 +111,7 @@ For performance reasons browsers limit text balancing to blocks that are ~6 line
 
 ### Pretty text wrapping
 
-Use the `text-pretty` utility to prevent orphans (a single word on its own line) at the end of a text block:
+Use the `text-pretty` utility to prefer better text wrapping and layout at the expense of speed. Behavior varies across browsers but often involves approaches like preventing orphans (a single word on its own line) at the end of a text block:
 
 <Figure>
 
@@ -139,6 +139,14 @@ Use the `text-pretty` utility to prevent orphans (a single word on its own line)
 
 </Figure>
 
+In addition to the above browsers may choose improvements like:
+
+- Reducing the variation in length between lines
+- Avoiding typographic rivers
+- Avoiding hyphenation on too many consecutive lines
+- Prioritizing different classes of soft wrap opportunities
+- [and more…](https://drafts.csswg.org/css-text-4/#valdef-text-wrap-style-pretty)
+
 ### Responsive design
 
 <ResponsiveDesign element="h1" property="text-wrap" defaultClass="text-pretty" featuredClass="text-balance" />