From 4d8d8bdab4b0e2931fcf92ce30d772b05a989434 Mon Sep 17 00:00:00 2001
From: Mark Otto <markdotto@gmail.com>
Date: Sun, 8 May 2016 15:07:16 -0700
Subject: [PATCH] Fixes #18768: Add migration docs for dropdowns

---
 docs/migration.md | 8 ++++++++
 1 file changed, 8 insertions(+)

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.