diff --git a/docs/migration.md b/docs/migration.md
index 649173183a88b9ce418b10492dbd812db37d36c6..ec431fc940fdfbef39d5e4ecfe8bfa59fd388b70 100644
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -87,7 +87,7 @@ New to Bootstrap 4 is the Reboot, a new stylesheet that builds on Normalize with
 - Renamed `.control-label` to `.form-control-label`.
 - Renamed `.input-lg` and `.input-sm` to `.form-control-lg` and `.form-control-sm`, respectively.
 - Dropped `.form-group-*` classes for simplicity's sake. Use `.form-control-*` classes instead now.
-- Dropped `.help-block`; superseded by the `.text-muted` utility class to reduce duplicate code.
+- Dropped `.help-block` and replaced it with `.form-text` for block-level help text. For inline help text and other flexible options, use utility classes like `.text-muted`.
 - Horizontal forms overhauled:
   - Dropped the `.form-horizontal` class requirement.
   - `.form-group` no longer applies styles from the `.row` via mixin, so `.row` is now required for horizontal grid layouts (e.g., `<div class="form-group row">`).