From 5feb51b3273334f647239790736c77d21a0cd689 Mon Sep 17 00:00:00 2001
From: Eric Liu <ericyl.us@gmail.com>
Date: Thu, 26 Nov 2020 11:42:18 -0800
Subject: [PATCH] docs(button): improve usage for icon-only, link buttons

---
 docs/src/pages/components/Button.svx | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/docs/src/pages/components/Button.svx b/docs/src/pages/components/Button.svx
index 10229c14..2507c9e0 100644
--- a/docs/src/pages/components/Button.svx
+++ b/docs/src/pages/components/Button.svx
@@ -42,10 +42,18 @@ description: High-level description
 
 ### Icon-only button
 
-<Button icon={Add16} hasIconOnly tooltipPosition="bottom" tooltipAlignment="center" iconDescription="Tooltip text" />
+Set `hasIconOnly` to `true` to use the icon-only button variant.
+
+**Note:** you must provide an `iconDescription` for the button tooltip.
+
+The tooltip position and alignment can be controlled by the `tooltipPosition`, `tooltipAlignment` props, respectively.
+
+<Button hasIconOnly tooltipPosition="bottom" tooltipAlignment="center" iconDescription="Tooltip text" icon={Add16} />
 
 ### Link button
 
+If an `href` value is specified, the component will render an [anchor element](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/a) with a "button" role.
+
 <Button href="#">Link button</Button>
 
 ### Custom element