more options, clearer options, and proper markdown formatting

diff --git a/docs/migration.md b/docs/migration.md
index c7d3f5840ff4e1a4f47376f7fd48f7fbde73bd5b..65f40e58592cf83e6813864f419498381fd1b7d2 100644 (file)
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -219,7 +219,7 @@ The following variables have been removed in v4.0.0. Use the `media-breakpoint-u
 
 The responsive utility classes have also been overhauled.
 
-- The `.hidden` and `.show` classes have been removed because they conflicted with jQuery's `$(...).hide()` and `$(...).show()` methods; you will instead need to use `style="display: none;", `style="display: block;" or `.invisible`.
+- The `.hidden` and `.show` classes have been removed because they conflicted with jQuery's `$(...).hide()` and `$(...).show()` methods. Instead, try toggling the `[hidden]` attribute, use inline styles like `style="display: none;"` and `style="display: block;"`, or toggle the `.invisible` class.
 - The old classes (`.hidden-xs` `.hidden-sm` `.hidden-md` `.hidden-lg` `.visible-xs-block` `.visible-xs-inline` `.visible-xs-inline-block` `.visible-sm-block` `.visible-sm-inline` `.visible-sm-inline-block` `.visible-md-block` `.visible-md-inline` `.visible-md-inline-block` `.visible-lg-block` `.visible-lg-inline` `.visible-lg-inline-block`) are gone.
 - They have been replaced by `.hidden-xs-up` `.hidden-xs-down` `.hidden-sm-up` `.hidden-sm-down` `.hidden-md-up` `.hidden-md-down` `.hidden-lg-up` `.hidden-lg-down`.
 - The `.hidden-*-up` classes hide the element when the viewport is at the given breakpoint or larger (e.g. `.hidden-md-up` hides an element on medium, large, and extra-large devices).