From: Mark Otto <markdotto@gmail.com>
Date: Sun, 8 May 2016 22:07:16 +0000 (-0700)
Subject: Fixes #18768: Add migration docs for dropdowns
X-Git-Tag: v4.0.0-alpha.3~96
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4d8d8bdab4b0e2931fcf92ce30d772b05a989434;p=thirdparty%2Fbootstrap.git

Fixes #18768: Add migration docs for dropdowns
---

diff --git a/docs/migration.md b/docs/migration.md
index 0ef91b4be9..88987d81dd 100644
--- a/docs/migration.md
+++ b/docs/migration.md
@@ -104,6 +104,14 @@ New to Bootstrap 4 is the Reboot, a new stylesheet that builds on Normalize with
 
 - Dropped the `.btn-group-xs` class entirely given removal of `.btn-xs`.
 
+### Dropdowns
+
+- Switched from parent selectors to singular classes for all components, modifiers, etc.
+- Dropdowns can be built with `<div>`s or `<ul>`s now.
+- Rebuilt dropdown styles and markup to provide easy, built-in support for `<a>` and `<button>` based dropdown items.
+- Dropdown items now require `.dropdown-item`.
+- Dropdown toggles no longer require an explicit `<span class="caret"></span>`; this is now provided automatically via CSS's `::after` on `.dropdown-toggle`.
+
 ### Grid system
 
 - Added a new `~480px` grid breakpoint, meaning there are now five total tiers.