Made showcase and API description tweaks for clarity

Author: amyrlam

packages/components/tests/dummy/app/templates/components/alert.hbs

@@ -57,7 +57,11 @@
 
     <dt class="dummy-indent">icon <code>string</code></dt>
     <dd class="dummy-indent">
-      <p>Shows an icon in the alert. Optional parameter.</p>
+      <p>Override the default
+        <code class="dummy-code">icon</code>
+        name determined by the
+        <code class="dummy-code">color</code>. Optional parameter.
+      </p>
       <p>Acceptable value:</p>
       <p>Any
         <a href="https://flight-hashicorp.vercel.app/" target="_blank" rel="noopener noreferrer">
@@ -195,6 +199,8 @@
   />
   <br />
 
+  Icon override variation:
+
   <Hds::Alert
     @color="critical"
     @icon="meh"
@@ -207,14 +213,13 @@
   />
   <br />
 
-  Other variations:
+  Title/description variations:
 
-  <Hds::Alert @color="critical" @icon="alert-triangle" @description="Description only please" />
+  <Hds::Alert @color="success" @description="Description only please" />
   <br />
 
   <Hds::Alert
-    @color="neutral"
-    @icon="alert-triangle"
+    @color="success"
     @title="Really long title, yet no description. Your Intention settings are currently set to default allow. This
       means that this view will show connections to every service in your
       cluster. We recommend changing your Intention settings to default deny and
@@ -224,8 +229,7 @@
   <br />
 
   <Hds::Alert
-    @color="highlight"
-    @icon="alert-triangle"
+    @color="success"
     @title="Description below has HTML"
     @description="Your Intention settings are currently set to default <strong>allow</strong>. This
       means that this view will show connections to every service in your