From 510f79dcac1b426f145f1324c214dc2f9f03993e Mon Sep 17 00:00:00 2001
From: pastelcyborg <168636120+pastelcyborg@users.noreply.github.com>
Date: Wed, 21 Aug 2024 15:35:59 -0400
Subject: [PATCH] Documentation updates

---
 .../50-50-desktop-with-description-cta.html    |  1 +
 .../50-50-desktop-with-list-item-cta.html      |  1 +
 templates/docs/patterns/tiered-list/index.md   | 18 +++++++++---------
 3 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/templates/docs/examples/patterns/tiered-list/50-50-desktop-with-description-cta.html b/templates/docs/examples/patterns/tiered-list/50-50-desktop-with-description-cta.html
index 63a0585cb..b70737b0c 100644
--- a/templates/docs/examples/patterns/tiered-list/50-50-desktop-with-description-cta.html
+++ b/templates/docs/examples/patterns/tiered-list/50-50-desktop-with-description-cta.html
@@ -17,6 +17,7 @@ <h2>H2 - up to two lines; ideally one.</h2>
     and that are reserved exclusively for them - either in their own data centre
     or via a 3rd party.</p>
 
+    <!-- Optional CTA block -->
     <div class="p-cta-block">
       <a href="#">Link to blog post &rsaquo;</a>
     </div>
diff --git a/templates/docs/examples/patterns/tiered-list/50-50-desktop-with-list-item-cta.html b/templates/docs/examples/patterns/tiered-list/50-50-desktop-with-list-item-cta.html
index 102a85591..d932da2b9 100644
--- a/templates/docs/examples/patterns/tiered-list/50-50-desktop-with-list-item-cta.html
+++ b/templates/docs/examples/patterns/tiered-list/50-50-desktop-with-list-item-cta.html
@@ -27,6 +27,7 @@ <h5>Rich portfolio of products</h5>
     cloud products: OpenStack, Kubernetes, IoT, support, security and
     compliance for Ubuntu.</p>
 
+    <!-- Optional CTA block -->
     <div class="p-cta-block">
       <a href="#">Link to blog post &rsaquo;</a>
     </div>
diff --git a/templates/docs/patterns/tiered-list/index.md b/templates/docs/patterns/tiered-list/index.md
index 2b9a3bb01..9487731e0 100644
--- a/templates/docs/patterns/tiered-list/index.md
+++ b/templates/docs/patterns/tiered-list/index.md
@@ -19,13 +19,13 @@ from a variety of tiered list layouts:
 
 The tiered list pattern is composed of the following elements:
 
-| Element               | Description                                                            |
-| --------------------- | ---------------------------------------------------------------------- |
-| Title (**required**)  | <code>h2</code> title text                                             |
-| Description           | <code>p</code> description text; [CTA block](/docs/patterns/cta-block) |
-| List item title       | Title text/content                                                     |
-| List item description | Description text/content; [CTA block](/docs/patterns/cta-block)        |
-| Call to action block  | [CTA block](/docs/patterns/cta-block) beneath the list                 |
+| Element               | Description                                                                         |
+| --------------------- | ----------------------------------------------------------------------------------- |
+| Title (**required**)  | <code>h2</code> title text                                                          |
+| Description           | <code>p</code> description text with optional [CTA block](/docs/patterns/cta-block) |
+| List item title       | Title text/content                                                                  |
+| List item description | Description text/content with optional [CTA block](/docs/patterns/cta-block)        |
+| Call to action block  | [CTA block](/docs/patterns/cta-block) beneath the list                              |
 
 ## 50/50 on desktop with description
 
@@ -87,8 +87,8 @@ View example of the tiered list pattern
 
 ## Additional CTA options
 
-In addition to the CTA block placed below the list, you're also able to add CTA
-blocks below the top-level description text, as well as below each list item's
+In addition to the CTA block placed below the list, you may also add CTA blocks
+below the top-level description text, as well as below each list item's
 description text.
 
 <div class="embedded-example"><a href="/docs/examples/patterns/tiered-list/50-50-desktop-with-description-cta/" class="js-example">