From a5c661a0f09184cf9db29a96da11ca195126ec8d Mon Sep 17 00:00:00 2001
From: JasonEtco <jasonetco@gmail.com>
Date: Sat, 4 Nov 2017 13:42:50 -0400
Subject: [PATCH] Improve .btn-link description

---
 modules/primer-buttons/README.md | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/modules/primer-buttons/README.md b/modules/primer-buttons/README.md
index 091c96e9..ad598e6b 100644
--- a/modules/primer-buttons/README.md
+++ b/modules/primer-buttons/README.md
@@ -126,7 +126,9 @@ Make any button full-width by adding `.btn-block`. It adds `width: 100%;`, chang
 
 ## Link button
 
-Buttons that looks like a link. **Note:** this should not be used with `.btn`.
+Create a button that looks like a link with `.btn-link`. Rather than using an `<a>` to trigger JS, this style on a `<button>` should be used for better accessibility.
+
+**The `.btn-link` class is not designed to be used with `.btn`; the overlapping styles are not compatible.**
 
 ```html
 <p><button class="btn-link" type="button">Link button</button></p>