Documentation updates

canonical · Aug 22, 2024 · 510f79d · 510f79d
1 parent 5424e2c
commit 510f79d
Show file tree

Hide file tree

Showing 3 changed files with 11 additions and 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
@@ -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
@@ -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
@@ -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">