Fixes #18705: Clarify removal of .help-text and update changes to .form-group for...

diff --git a/docs/migration.md b/docs/migration.md
index 88987d81dd9c24e8ede6f2357a70dd5c8795977b..649173183a88b9ce418b10492dbd812db37d36c6 100644 (file)
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -87,10 +87,10 @@ 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`. Use the `.text-muted` utility class instead.
+- Dropped `.help-block`; superseded by the `.text-muted` utility class to reduce duplicate code.
 - Horizontal forms overhauled:
   - Dropped the `.form-horizontal` class requirement.
-  - `.form-group` no longer mixins the `.row` class, so it's now required for grid layouts.
+  - `.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">`).
   - Added new `.form-control-label` class to vertically center labels with `.form-control`s.
 
 ### Buttons