Remove .dl-horizontal; it's redundant to the grid system; fixes #18652

[skip sauce]

2 files changed, 3 insertions, 3 deletions

diff --git a/docs/content/typography.md b/docs/content/typography.md
index 651e2c49c..a028e5e1d 100644
--- a/docs/content/typography.md
+++ b/docs/content/typography.md
@@ -215,12 +215,12 @@ Place all list items on a single line with `display: inline-block;` and some bas
 </ul>
 {% endexample %}
 
-### Horizontal description
+### Description list alignment
 
 Align terms and descriptions horizontally by using our grid system's predefined classes (or semantic mixins). For longer terms, you can optionally add a `.text-truncate` class to truncate the text with an ellipsis.
 
 {% example html %}
-<dl class="dl-horizontal">
+<dl class="row">
   <dt class="col-sm-3">Description lists</dt>
   <dd class="col-sm-9">A description list is perfect for defining terms.</dd>
 
diff --git a/docs/migration.md b/docs/migration.md
index d710d1768..76e29a253 100644
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -54,7 +54,7 @@ New to Bootstrap 4 is the Reboot, a new stylesheet that builds on Normalize with
 
 - Moved all `.text-` utilities to the `_utilities.scss` file.
 - Dropped the `.page-header` class entirely.
-- `.dl-horizontal` now requires grid classes, increasing flexbility in column widths.
+- `.dl-horizontal` has been dropped. Instead, use `.row` on `<dl>` and use grid column classes on its `<dt>` and `<dd>` children.
 - Custom `<blockquote>` styling has moved to classes—`.blockquote` and the `.blockquote-reverse` modifier.
 
 ### Images