diff --git a/docs/components/button-dropdown.md b/docs/components/button-dropdown.md
index ecad0d862a..80d8911b96 100644
--- a/docs/components/button-dropdown.md
+++ b/docs/components/button-dropdown.md
@@ -17,9 +17,9 @@ Button dropdowns require the [dropdown plugin]({{ site.baseurl }}/components/dro
* Will be replaced with the ToC, excluding the "Contents" header
{:toc}
-### Single button dropdowns
+## Single button dropdowns
-Turn a button into a dropdown toggle with some basic markup changes.
+Turn a button into a dropdown toggle with some basic markup changes for the menu itself and the button used to trigger it.
@@ -100,9 +100,11 @@ Turn a button into a dropdown toggle with some basic markup changes.
{% endhighlight %}
-### Split button dropdowns
+## Split button dropdowns
-Similarly, create split button dropdowns with nearly the same markup as single button dropdowns, but add the `.dropdown-toggle-split` class for proper spacing around the dropdown caret.
+Similarly, create split button dropdowns with virtually the same markup as single button dropdowns, but with the addition of `.dropdown-toggle-split` for proper spacing around the dropdown caret.
+
+We use this extra class to reduce the horizontal `padding` on either side of the caret by 25% and remove the `margin-left` that's added for regular button dropdowns. Those extra changes keep the caret centered in the split button and provide a more appropriately sized hit area next to the main button.
@@ -202,9 +204,9 @@ Similarly, create split button dropdowns with nearly the same markup as single b
{% endhighlight %}
-### Sizing
+## Sizing
-Button dropdowns work with buttons of all sizes.
+Button dropdowns work with buttons of all sizes, including default and split dropdown buttons.
@@ -264,7 +266,7 @@ Button dropdowns work with buttons of all sizes.
{% highlight html %}
-
+
+
+
+
+
+ ...
+
+
-
+
+
+
+
+
+ ...
+
+
{% endhighlight %}
-### Dropup variation
+## Dropup variation
Trigger dropdown menus above elements by adding `.dropup` to the parent.