rewrite the split button dropdowns section

2 files changed, 537 insertions, 533 deletions

diff --git a/docs/components.html b/docs/components.html
index 4d7b6d3bb..c96e4aa03 100644
--- a/docs/components.html
+++ b/docs/components.html
@@ -196,87 +196,83 @@
     <h1>Button dropdown menus <small>Built on button groups to provide contextual menus</small></h1>
   </div>
 
-  <h2>Button dropdowns</h2>
 
-  <h3>Overview and examples</h3>
+  <h2>Overview and examples</h2>
   <p>Use any button to trigger a dropdown menu by placing it within a <code>.btn-group</code> and providing the proper menu markup.</p>
-  <div class="btn-toolbar" style="margin-top: 18px;">
-    <div class="btn-group">
-      <button class="btn dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown">Danger <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
+      <div class="btn-group">
+        <button class="btn dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown">Action <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown">Danger <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown">Warning <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-success dropdown-toggle" data-toggle="dropdown">Success <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-info dropdown-toggle" data-toggle="dropdown">Info <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown">Inverse <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div><!-- /btn-toolbar -->
   </div>
-  <div class="btn-toolbar">
-    <div class="btn-group">
-      <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown">Warning <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-success dropdown-toggle" data-toggle="dropdown">Success <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-info dropdown-toggle" data-toggle="dropdown">Info <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown">Inverse <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div><!-- /btn-toolbar -->
-
-  <h3>Example markup</h3>
-  <p>Similar to a button group, our markup uses regular button markup, but with a handful of additions to refine the style and support Bootstrap's dropdown jQuery plugin.</p>
 <pre class="prettyprint linenums">
 &lt;div class="btn-group"&gt;
   &lt;a class="btn dropdown-toggle" data-toggle="dropdown" href="#"&gt;
@@ -291,188 +287,191 @@
 
   <h3>Works with all button sizes</h3>
   <p>Button dropdowns work at any size. your button sizes to <code>.btn-large</code>, <code>.btn-small</code>, or <code>.btn-mini</code>.</p>
-  <div class="btn-toolbar" style="margin-top: 18px;">
-    <div class="btn-group">
-      <button class="btn btn-large dropdown-toggle" data-toggle="dropdown">Large button <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-small dropdown-toggle" data-toggle="dropdown">Small button <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-mini dropdown-toggle" data-toggle="dropdown">Mini button <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div><!-- /btn-toolbar -->
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
+      <div class="btn-group">
+        <button class="btn btn-large dropdown-toggle" data-toggle="dropdown">Large button <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-small dropdown-toggle" data-toggle="dropdown">Small button <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-mini dropdown-toggle" data-toggle="dropdown">Mini button <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div><!-- /btn-toolbar -->
+  </div>
 
   <h3>Requires javascript</h3>
   <p>Button dropdowns require the <a href="./javascript.html#dropdowns">Bootstrap dropdown plugin</a> to function.</p>
   <p>In some cases&mdash;like mobile&mdash;dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.</p>
 
-  <br>
 
-  <h2>Split button dropdowns</h2>
+  <hr class="bs-docs-separator">
+
 
-  <h3>Overview and examples</h3>
+  <h2>Split button dropdowns</h2>
   <p>Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.</p>
-  <div class="btn-toolbar" style="margin-top: 18px;">
-    <div class="btn-group">
-      <button class="btn">Action</button>
-      <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-primary">Action</button>
-      <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-danger">Danger</button>
-      <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div>
-  <div class="btn-toolbar">
-    <div class="btn-group">
-      <button class="btn btn-warning">Warning</button>
-      <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-success">Success</button>
-      <button class="btn btn-success dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-info">Info</button>
-      <button class="btn btn-info dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
+      <div class="btn-group">
+        <button class="btn">Action</button>
+        <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-primary">Action</button>
+        <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-danger">Danger</button>
+        <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-warning">Warning</button>
+        <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-success">Success</button>
+        <button class="btn btn-success dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-info">Info</button>
+        <button class="btn btn-info dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-inverse">Inverse</button>
+        <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div><!-- /btn-toolbar -->
   </div>
-  <div class="btn-toolbar">
-    <div class="btn-group">
-      <button class="btn btn-inverse">Inverse</button>
-      <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div><!-- /btn-toolbar -->
-  <h3>Sizes</h3>
-  <p>Utilize the extra button classes <code>.btn-mini</code>, <code>.btn-small</code>, or <code>.btn-large</code> for sizing.</p>
-  <div class="btn-toolbar">
-    <div class="btn-group">
-      <button class="btn btn-large">Large action</button>
-      <button class="btn btn-large dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div><!-- /btn-toolbar -->
-  <div class="btn-toolbar">
-    <div class="btn-group">
-      <button class="btn btn-small">Small action</button>
-      <button class="btn btn-small dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div><!-- /btn-toolbar -->
-  <div class="btn-toolbar">
-    <div class="btn-group">
-      <button class="btn btn-mini">Mini action</button>
-      <button class="btn btn-mini dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div><!-- /btn-toolbar -->
 <pre class="prettyprint linenums">
 &lt;div class="btn-group"&gt;
-  ...
-  &lt;ul class="dropdown-menu pull-right"&gt;
+  &lt;button class="btn"&gt;Action&lt;/button&gt;
+  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
+    &lt;span class="caret"&gt;&lt;/span&gt;
+  &lt;/button&gt;
+  &lt;ul class="dropdown-menu"&gt;
     &lt;!-- dropdown menu links --&gt;
   &lt;/ul&gt;
 &lt;/div&gt;
 </pre>
 
-  <h3>Example markup</h3>
-  <p>We expand on the normal button dropdowns to provide a second button action that operates as a separate dropdown trigger.</p>
+  <h3>Sizes</h3>
+  <p>Utilize the extra button classes <code>.btn-mini</code>, <code>.btn-small</code>, or <code>.btn-large</code> for sizing.</p>
+  <div class="bs-docs-example">
+    <div class="btn-toolbar">
+      <div class="btn-group">
+        <button class="btn btn-large">Large action</button>
+        <button class="btn btn-large dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div><!-- /btn-toolbar -->
+    <div class="btn-toolbar">
+      <div class="btn-group">
+        <button class="btn btn-small">Small action</button>
+        <button class="btn btn-small dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div><!-- /btn-toolbar -->
+    <div class="btn-toolbar">
+      <div class="btn-group">
+        <button class="btn btn-mini">Mini action</button>
+        <button class="btn btn-mini dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div><!-- /btn-toolbar -->
+  </div>
 <pre class="prettyprint linenums">
 &lt;div class="btn-group"&gt;
-  &lt;button class="btn"&gt;Action&lt;/button&gt;
-  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
+  &lt;button class="btn btn-mini"&gt;Action&lt;/button&gt;
+  &lt;button class="btn btn-mini dropdown-toggle" data-toggle="dropdown"&gt;
     &lt;span class="caret"&gt;&lt;/span&gt;
   &lt;/button&gt;
   &lt;ul class="dropdown-menu"&gt;
@@ -480,31 +479,34 @@
   &lt;/ul&gt;
 &lt;/div&gt;
 </pre>
+
   <h3>Dropup menus</h3>
   <p>Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of <code>.dropdown-menu</code>. It will flip the direction of the <code>.caret</code> and reposition the menu itself to move from the bottom up instead of top down.</p>
-  <div class="btn-toolbar" style="margin-top: 9px;">
-    <div class="btn-group dropup">
-      <button class="btn">Dropup</button>
-      <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group dropup">
-      <button class="btn primary">Right dropup</button>
-      <button class="btn primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu pull-right">
-        <li><a href="#">Action</a></li>
-        <li><a href="#">Another action</a></li>
-        <li><a href="#">Something else here</a></li>
-        <li class="divider"></li>
-        <li><a href="#">Separated link</a></li>
-      </ul>
-    </div><!-- /btn-group -->
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
+      <div class="btn-group dropup">
+        <button class="btn">Dropup</button>
+        <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group dropup">
+        <button class="btn primary">Right dropup</button>
+        <button class="btn primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu pull-right">
+          <li><a href="#">Action</a></li>
+          <li><a href="#">Another action</a></li>
+          <li><a href="#">Something else here</a></li>
+          <li class="divider"></li>
+          <li><a href="#">Separated link</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div>
   </div>
 <pre class="prettyprint linenums">
 &lt;div class="btn-group dropup"&gt;
diff --git a/docs/templates/pages/components.mustache b/docs/templates/pages/components.mustache
index 3001102a8..cf40248af 100644
--- a/docs/templates/pages/components.mustache
+++ b/docs/templates/pages/components.mustache
@@ -119,87 +119,83 @@
     <h1>{{_i}}Button dropdown menus{{/i}} <small>{{_i}}Built on button groups to provide contextual menus{{/i}}</small></h1>
   </div>
 
-  <h2>{{_i}}Button dropdowns{{/i}}</h2>
 
-  <h3>{{_i}}Overview and examples{{/i}}</h3>
+  <h2>{{_i}}Overview and examples{{/i}}</h2>
   <p>{{_i}}Use any button to trigger a dropdown menu by placing it within a <code>.btn-group</code> and providing the proper menu markup.{{/i}}</p>
-  <div class="btn-toolbar" style="margin-top: 18px;">
-    <div class="btn-group">
-      <button class="btn dropdown-toggle" data-toggle="dropdown">{{_i}}Action{{/i}} <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown">{{_i}}Action{{/i}} <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown">{{_i}}Danger{{/i}} <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div>
-  <div class="btn-toolbar">
-    <div class="btn-group">
-      <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown">{{_i}}Warning{{/i}} <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-success dropdown-toggle" data-toggle="dropdown">{{_i}}Success{{/i}} <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-info dropdown-toggle" data-toggle="dropdown">{{_i}}Info{{/i}} <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown">{{_i}}Inverse{{/i}} <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div><!-- /btn-toolbar -->
-
-  <h3>{{_i}}Example markup{{/i}}</h3>
-  <p>{{_i}}Similar to a button group, our markup uses regular button markup, but with a handful of additions to refine the style and support Bootstrap's dropdown jQuery plugin.{{/i}}</p>
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
+      <div class="btn-group">
+        <button class="btn dropdown-toggle" data-toggle="dropdown">{{_i}}Action{{/i}} <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown">{{_i}}Action{{/i}} <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown">{{_i}}Danger{{/i}} <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown">{{_i}}Warning{{/i}} <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-success dropdown-toggle" data-toggle="dropdown">{{_i}}Success{{/i}} <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-info dropdown-toggle" data-toggle="dropdown">{{_i}}Info{{/i}} <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown">{{_i}}Inverse{{/i}} <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div><!-- /btn-toolbar -->
+  </div>{{! /example }}
 <pre class="prettyprint linenums">
 &lt;div class="btn-group"&gt;
   &lt;a class="btn dropdown-toggle" data-toggle="dropdown" href="#"&gt;
@@ -214,188 +210,191 @@
 
   <h3>{{_i}}Works with all button sizes{{/i}}</h3>
   <p>{{_i}}Button dropdowns work at any size. your button sizes to <code>.btn-large</code>, <code>.btn-small</code>, or <code>.btn-mini</code>.{{/i}}</p>
-  <div class="btn-toolbar" style="margin-top: 18px;">
-    <div class="btn-group">
-      <button class="btn btn-large dropdown-toggle" data-toggle="dropdown">{{_i}}Large button{{/i}} <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-small dropdown-toggle" data-toggle="dropdown">{{_i}}Small button{{/i}} <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-mini dropdown-toggle" data-toggle="dropdown">{{_i}}Mini button{{/i}} <span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div><!-- /btn-toolbar -->
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
+      <div class="btn-group">
+        <button class="btn btn-large dropdown-toggle" data-toggle="dropdown">{{_i}}Large button{{/i}} <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-small dropdown-toggle" data-toggle="dropdown">{{_i}}Small button{{/i}} <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-mini dropdown-toggle" data-toggle="dropdown">{{_i}}Mini button{{/i}} <span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div><!-- /btn-toolbar -->
+  </div>{{! /example }}
 
   <h3>{{_i}}Requires javascript{{/i}}</h3>
   <p>{{_i}}Button dropdowns require the <a href="./javascript.html#dropdowns">Bootstrap dropdown plugin</a> to function.{{/i}}</p>
   <p>{{_i}}In some cases&mdash;like mobile&mdash;dropdown menus will extend outside the viewport. You need to resolve the alignment manually or with custom javascript.{{/i}}</p>
 
-  <br>
 
-  <h2>{{_i}}Split button dropdowns{{/i}}</h2>
+  <hr class="bs-docs-separator">
 
-  <h3>{{_i}}Overview and examples{{/i}}</h3>
+
+  <h2>{{_i}}Split button dropdowns{{/i}}</h2>
   <p>{{_i}}Building on the button group styles and markup, we can easily create a split button. Split buttons feature a standard action on the left and a dropdown toggle on the right with contextual links.{{/i}}</p>
-  <div class="btn-toolbar" style="margin-top: 18px;">
-    <div class="btn-group">
-      <button class="btn">{{_i}}Action{{/i}}</button>
-      <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-primary">{{_i}}Action{{/i}}</button>
-      <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-danger">{{_i}}Danger{{/i}}</button>
-      <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div>
-  <div class="btn-toolbar">
-    <div class="btn-group">
-      <button class="btn btn-warning">{{_i}}Warning{{/i}}</button>
-      <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-success">{{_i}}Success{{/i}}</button>
-      <button class="btn btn-success dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group">
-      <button class="btn btn-info">{{_i}}Info{{/i}}</button>
-      <button class="btn btn-info dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div>
-  <div class="btn-toolbar">
-    <div class="btn-group">
-      <button class="btn btn-inverse">{{_i}}Inverse{{/i}}</button>
-      <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div><!-- /btn-toolbar -->
-  <h3>{{_i}}Sizes{{/i}}</h3>
-  <p>{{_i}}Utilize the extra button classes <code>.btn-mini</code>, <code>.btn-small</code>, or <code>.btn-large</code> for sizing.{{/i}}</p>
-  <div class="btn-toolbar">
-    <div class="btn-group">
-      <button class="btn btn-large">{{_i}}Large action{{/i}}</button>
-      <button class="btn btn-large dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div><!-- /btn-toolbar -->
-  <div class="btn-toolbar">
-    <div class="btn-group">
-      <button class="btn btn-small">{{_i}}Small action{{/i}}</button>
-      <button class="btn btn-small dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div><!-- /btn-toolbar -->
-  <div class="btn-toolbar">
-    <div class="btn-group">
-      <button class="btn btn-mini">{{_i}}Mini action{{/i}}</button>
-      <button class="btn btn-mini dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div><!-- /btn-toolbar -->
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
+      <div class="btn-group">
+        <button class="btn">{{_i}}Action{{/i}}</button>
+        <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-primary">{{_i}}Action{{/i}}</button>
+        <button class="btn btn-primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-danger">{{_i}}Danger{{/i}}</button>
+        <button class="btn btn-danger dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-warning">{{_i}}Warning{{/i}}</button>
+        <button class="btn btn-warning dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-success">{{_i}}Success{{/i}}</button>
+        <button class="btn btn-success dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-info">{{_i}}Info{{/i}}</button>
+        <button class="btn btn-info dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group">
+        <button class="btn btn-inverse">{{_i}}Inverse{{/i}}</button>
+        <button class="btn btn-inverse dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div><!-- /btn-toolbar -->
+  </div>{{! /example }}
 <pre class="prettyprint linenums">
 &lt;div class="btn-group"&gt;
-  ...
-  &lt;ul class="dropdown-menu pull-right"&gt;
+  &lt;button class="btn"&gt;{{_i}}Action{{/i}}&lt;/button&gt;
+  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
+    &lt;span class="caret"&gt;&lt;/span&gt;
+  &lt;/button&gt;
+  &lt;ul class="dropdown-menu"&gt;
     &lt;!-- {{_i}}dropdown menu links{{/i}} --&gt;
   &lt;/ul&gt;
 &lt;/div&gt;
 </pre>
 
-  <h3>{{_i}}Example markup{{/i}}</h3>
-  <p>{{_i}}We expand on the normal button dropdowns to provide a second button action that operates as a separate dropdown trigger.{{/i}}</p>
+  <h3>{{_i}}Sizes{{/i}}</h3>
+  <p>{{_i}}Utilize the extra button classes <code>.btn-mini</code>, <code>.btn-small</code>, or <code>.btn-large</code> for sizing.{{/i}}</p>
+  <div class="bs-docs-example">
+    <div class="btn-toolbar">
+      <div class="btn-group">
+        <button class="btn btn-large">{{_i}}Large action{{/i}}</button>
+        <button class="btn btn-large dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div><!-- /btn-toolbar -->
+    <div class="btn-toolbar">
+      <div class="btn-group">
+        <button class="btn btn-small">{{_i}}Small action{{/i}}</button>
+        <button class="btn btn-small dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div><!-- /btn-toolbar -->
+    <div class="btn-toolbar">
+      <div class="btn-group">
+        <button class="btn btn-mini">{{_i}}Mini action{{/i}}</button>
+        <button class="btn btn-mini dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div><!-- /btn-toolbar -->
+  </div>{{! /example }}
 <pre class="prettyprint linenums">
 &lt;div class="btn-group"&gt;
-  &lt;button class="btn"&gt;{{_i}}Action{{/i}}&lt;/button&gt;
-  &lt;button class="btn dropdown-toggle" data-toggle="dropdown"&gt;
+  &lt;button class="btn btn-mini"&gt;{{_i}}Action{{/i}}&lt;/button&gt;
+  &lt;button class="btn btn-mini dropdown-toggle" data-toggle="dropdown"&gt;
     &lt;span class="caret"&gt;&lt;/span&gt;
   &lt;/button&gt;
   &lt;ul class="dropdown-menu"&gt;
@@ -403,32 +402,35 @@
   &lt;/ul&gt;
 &lt;/div&gt;
 </pre>
+
   <h3>{{_i}}Dropup menus{{/i}}</h3>
   <p>{{_i}}Dropdown menus can also be toggled from the bottom up by adding a single class to the immediate parent of <code>.dropdown-menu</code>. It will flip the direction of the <code>.caret</code> and reposition the menu itself to move from the bottom up instead of top down.{{/i}}</p>
-  <div class="btn-toolbar" style="margin-top: 9px;">
-    <div class="btn-group dropup">
-      <button class="btn">{{_i}}Dropup{{/i}}</button>
-      <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-    <div class="btn-group dropup">
-      <button class="btn primary">{{_i}}Right dropup{{/i}}</button>
-      <button class="btn primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
-      <ul class="dropdown-menu pull-right">
-        <li><a href="#">{{_i}}Action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Another action{{/i}}</a></li>
-        <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
-        <li class="divider"></li>
-        <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
-      </ul>
-    </div><!-- /btn-group -->
-  </div>
+  <div class="bs-docs-example">
+    <div class="btn-toolbar" style="margin: 0;">
+      <div class="btn-group dropup">
+        <button class="btn">{{_i}}Dropup{{/i}}</button>
+        <button class="btn dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+      <div class="btn-group dropup">
+        <button class="btn primary">{{_i}}Right dropup{{/i}}</button>
+        <button class="btn primary dropdown-toggle" data-toggle="dropdown"><span class="caret"></span></button>
+        <ul class="dropdown-menu pull-right">
+          <li><a href="#">{{_i}}Action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Another action{{/i}}</a></li>
+          <li><a href="#">{{_i}}Something else here{{/i}}</a></li>
+          <li class="divider"></li>
+          <li><a href="#">{{_i}}Separated link{{/i}}</a></li>
+        </ul>
+      </div><!-- /btn-group -->
+    </div>
+  </div>{{! /example }}
 <pre class="prettyprint linenums">
 &lt;div class="btn-group dropup"&gt;
   &lt;button class="btn"&gt;{{_i}}Dropup{{/i}}&lt;/button&gt;