From 0c0c44462a49ed65ad56300bff240b0703e0f5ce Mon Sep 17 00:00:00 2001
From: Cristiano Rastelli <public@didoo.net>
Date: Fri, 27 May 2022 13:01:54 +0100
Subject: [PATCH 1/2] =?UTF-8?q?added=20back=20the=20top=20banner=20about?=
 =?UTF-8?q?=20=E2=80=9Cbuttons=20vs=20links=E2=80=9D=20in=20the=20`Button`?=
 =?UTF-8?q?=20doc=20page?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../dummy-link-cta-button-banner/index.hbs    | 27 +++++++++++--------
 .../dummy/app/templates/components/button.hbs |  2 +-
 .../app/templates/components/link/inline.hbs  |  2 --
 .../templates/components/link/standalone.hbs  |  2 --
 4 files changed, 17 insertions(+), 16 deletions(-)

diff --git a/packages/components/tests/dummy/app/components/dummy-link-cta-button-banner/index.hbs b/packages/components/tests/dummy/app/components/dummy-link-cta-button-banner/index.hbs
index febaeb38b25..60546de1aa8 100644
--- a/packages/components/tests/dummy/app/components/dummy-link-cta-button-banner/index.hbs
+++ b/packages/components/tests/dummy/app/components/dummy-link-cta-button-banner/index.hbs
@@ -1,25 +1,30 @@
 <section class="dummy-link-cta-button-banner">
-  <h3>Links, Buttons, CTAs...oh my!</h3>
+  <h3>Links, Buttons, Links that look like Buttons...oh my!</h3>
   <h4>When to use a Link</h4>
   <p>A link navigates the user to a new destination via a URL or route. Use
     <LinkTo @route="components.link.inline"><code>Link::Inline</code></LinkTo>
     within a body of text and
     <LinkTo @route="components.link.standalone"><code>Link::Standalone</code></LinkTo>
     outside of a body of text, ie. on its own or in a list.</p>
-  <h4>When to use a CTA</h4>
-  <p>A CTA is a link that looks like a button. It navigates the user to a new destination via a URL or route, but has
-    more visual weight than a standard link. Use a
-    <LinkTo @route="components.button"><code>Button</code></LinkTo>
-    as a link (with
-    <code>@href</code>
-    or
-    <code>@route</code>) to guide the user and encourage interaction. Use sparingly as overuse dilutes its importance.</p>
   <h4>When to use a Button</h4>
   <p>A button triggers an action within the page, ie. opening a dropdown or submitting a form.
     <LinkTo @route="components.button"><code>Button</code></LinkTo>
-    is offered in a variety of visual weights to provide flexibility in use. Please refer to the Design Guidelines to
-    learn more about the different variants.
+    is offered in a variety of visual weights to provide flexibility in use. Please refer to the
+    <LinkTo @route="components.button">Design Guidelines</LinkTo>
+    to learn more about the different variants.
   </p>
+  <h4>When to use a Link that looks like a Button</h4>
+  <p>Occasionally there is a need to display a link with more prominence (ie. a CTA or
+    <em>Cancel</em>
+    next to
+    <em>Submit</em>), so the
+    <LinkTo @route="components.button"><code>Button</code></LinkTo>
+    component offers support to be used as a link (with
+    <code>@href</code>
+    or
+    <code>@route</code>). Please refer to the
+    <LinkTo @route="components.button">How to use</LinkTo>
+    section to learn more.</p>
   <h4>Want to learn more?</h4>
   <p><a href="https://medium.com/@h_locke/links-vs-buttons-e8b523660fb3" target="_blank" rel="noopener noreferrer">Links
       vs Buttons</a>
diff --git a/packages/components/tests/dummy/app/templates/components/button.hbs b/packages/components/tests/dummy/app/templates/components/button.hbs
index 90834684332..7830b428645 100644
--- a/packages/components/tests/dummy/app/templates/components/button.hbs
+++ b/packages/components/tests/dummy/app/templates/components/button.hbs
@@ -2,7 +2,7 @@
 
 <h2 class="dummy-h2">Button component</h2>
 
-{{! <DummyLinkCtaButtonBanner /> }}
+<DummyLinkCtaButtonBanner />
 
 <section>
   <h3 class="dummy-h3" id="component-api"><a href="#component-api" class="dummy-link-section">§</a> Component API</h3>
diff --git a/packages/components/tests/dummy/app/templates/components/link/inline.hbs b/packages/components/tests/dummy/app/templates/components/link/inline.hbs
index 00f1bcbcba2..d8f57f1d809 100644
--- a/packages/components/tests/dummy/app/templates/components/link/inline.hbs
+++ b/packages/components/tests/dummy/app/templates/components/link/inline.hbs
@@ -4,8 +4,6 @@
   Link::Inline
 </h2>
 
-{{! <DummyLinkCtaButtonBanner /> }}
-
 <section>
   <div class="dummy-banner dummy-banner--info">
     <p class="dummy-paragraph">👀 <strong>Notice</strong> 👀</p>
diff --git a/packages/components/tests/dummy/app/templates/components/link/standalone.hbs b/packages/components/tests/dummy/app/templates/components/link/standalone.hbs
index 57110241f8a..3fe54736e19 100644
--- a/packages/components/tests/dummy/app/templates/components/link/standalone.hbs
+++ b/packages/components/tests/dummy/app/templates/components/link/standalone.hbs
@@ -2,8 +2,6 @@
 
 <h2 class="dummy-h2">Link::Standalone</h2>
 
-{{! <DummyLinkCtaButtonBanner /> }}
-
 <section>
   <h3 class="dummy-h3" id="overview"><a href="#overview">§</a> Overview</h3>
 

From 188396a01714eef777fba72c65a2e1c4b34c903b Mon Sep 17 00:00:00 2001
From: Cristiano Rastelli <public@didoo.net>
Date: Mon, 30 May 2022 10:56:39 +0100
Subject: [PATCH 2/2] added back banner for links too

---
 .../tests/dummy/app/templates/components/link/inline.hbs        | 2 ++
 .../tests/dummy/app/templates/components/link/standalone.hbs    | 2 ++
 2 files changed, 4 insertions(+)

diff --git a/packages/components/tests/dummy/app/templates/components/link/inline.hbs b/packages/components/tests/dummy/app/templates/components/link/inline.hbs
index d8f57f1d809..253bcb5e75e 100644
--- a/packages/components/tests/dummy/app/templates/components/link/inline.hbs
+++ b/packages/components/tests/dummy/app/templates/components/link/inline.hbs
@@ -4,6 +4,8 @@
   Link::Inline
 </h2>
 
+<DummyLinkCtaButtonBanner />
+
 <section>
   <div class="dummy-banner dummy-banner--info">
     <p class="dummy-paragraph">👀 <strong>Notice</strong> 👀</p>
diff --git a/packages/components/tests/dummy/app/templates/components/link/standalone.hbs b/packages/components/tests/dummy/app/templates/components/link/standalone.hbs
index 3fe54736e19..0c0366b9125 100644
--- a/packages/components/tests/dummy/app/templates/components/link/standalone.hbs
+++ b/packages/components/tests/dummy/app/templates/components/link/standalone.hbs
@@ -2,6 +2,8 @@
 
 <h2 class="dummy-h2">Link::Standalone</h2>
 
+<DummyLinkCtaButtonBanner />
+
 <section>
   <h3 class="dummy-h3" id="overview"><a href="#overview">§</a> Overview</h3>