From 03c91b83bd15f87f9f08ccbea86e3ecfdfb549f8 Mon Sep 17 00:00:00 2001
From: Mark Otto <markdotto@gmail.com>
Date: Mon, 10 Aug 2015 16:11:44 -0700
Subject: [PATCH] simplify some button docs copy

---
 docs/components/buttons.md | 20 ++++++--------------
 1 file changed, 6 insertions(+), 14 deletions(-)

diff --git a/docs/components/buttons.md b/docs/components/buttons.md
index 6e25ebe22e..0dbb7a256e 100644
--- a/docs/components/buttons.md
+++ b/docs/components/buttons.md
@@ -4,7 +4,7 @@ title: Buttons
 group: components
 ---
 
-Buttons are used to execute actions in forms, dialogs, and more. Use any of the available button classes to quickly create a styled button.
+Use Bootstrap's custom button styles for actions in forms, dialogs, and more. Includes support for a handful of contextual variations, sizes, states, and more.
 
 ## Contents
 
@@ -104,7 +104,11 @@ Buttons will appear pressed (with a darker background, darker border, and inset
 
 ## Disabled state
 
-Make buttons look unclickable by adding the `disabled` boolean attribute to any `<button>` element.
+Make buttons look inactive by adding the `disabled` boolean attribute to any `<button>` element.
+
+{% callout info %}
+**Heads up!** IE9 and below render disabled buttons with gray, shadowed text that we can't override.
+{% endcallout %}
 
 {% example html %}
 <button type="button" class="btn btn-lg btn-primary" disabled>Primary button</button>
@@ -118,24 +122,12 @@ As `<a>` elements don't support the `disabled` attribute, you must add the `.dis
 <a href="#" class="btn btn-secondary btn-lg disabled" role="button">Link</a>
 {% endexample %}
 
-{% callout warning %}
-#### Cross-browser compatibility
-
-If you add the `disabled` attribute to a `<button>`, Internet Explorer 9 and below will render text gray with a nasty text-shadow that we cannot fix.
-{% endcallout %}
-
 {% callout warning %}
 #### Link functionality caveat
 
 This class uses `pointer-events: none` to try to disable the link functionality of `<a>`s, but that CSS property is not yet standardized and isn't fully supported in Opera 18 and below, or in Internet Explorer 11\. In addition, even in browsers that do support `pointer-events: none`, keyboard navigation remains unaffected, meaning that sighted keyboard users and users of assistive technologies will still be able to activate these links. So to be safe, use custom JavaScript to disable such links.
 {% endcallout %}
 
-{% callout warning %}
-#### Context-specific usage
-
-While button classes can be used on `<a>` and `<button>` elements, only `<button>` elements are supported within our nav and navbar components.
-{% endcallout %}
-
 ## Button plugin
 
 Do more with buttons. Control button states or create groups of buttons for more components like toolbars.
-- 
2.47.2