From 7dec363f54c29ed5d9808e85748441730de14106 Mon Sep 17 00:00:00 2001
From: Alex Haslam <alex.haslam@carbonre.com>
Date: Sat, 31 Jan 2026 20:31:46 +0000
Subject: [PATCH] Tidy up examples in docs

---
 exampleSite/content/docs/shortcodes/index.md | 32 +++++++++-----------
 1 file changed, 14 insertions(+), 18 deletions(-)

diff --git a/exampleSite/content/docs/shortcodes/index.md b/exampleSite/content/docs/shortcodes/index.md
index 0ab70a09..d5bf0d60 100644
--- a/exampleSite/content/docs/shortcodes/index.md
+++ b/exampleSite/content/docs/shortcodes/index.md
@@ -121,17 +121,15 @@ The alert sign (`+` or `-`) is optional to control whether the admonition is fol
 
 ```md
 {{</* accordion mode="open" separated=true */>}}
-  {{</* accordionItem title="What is Blowfish?" open=true */>}}
-  Blowfish is a fast, configurable Hugo theme. Here’s a quick list:
-  - **Fast builds**
-  - Flexible layouts
-  - `config`-driven
-  
-  {{</* badge */>}}New{{</* /badge */>}}
+  {{</* accordionItem title="Markdown example" open=true */>}}
+  This item demonstrates Markdown rendering:
+  - **Bold text**
+  - Lists
+  - `inline code`
   {{</* /accordionItem */>}}
 
-  {{</* accordionItem title="Can I use shortcodes?" md=false */>}}
-  Yes. Content inside items can contain other shortcodes like alerts:
+  {{</* accordionItem title="Shortcode example" md=false */>}}
+  This item demonstrates shortcode rendering with <code>md=false</code>:
   
   {{</* alert */>}}This is an inline alert.{{</* /alert */>}}
   {{</* /accordionItem */>}}
@@ -139,17 +137,15 @@ The alert sign (`+` or `-`) is optional to control whether the admonition is fol
 ```
 
 {{< accordion mode="open" separated=true >}}
-  {{< accordionItem title="What is Blowfish?" open=true >}}
-  Blowfish is a fast, configurable Hugo theme. Here’s a quick list:
-  - **Fast builds**
-  - Flexible layouts
-  - `config`-driven
-  
-  
+  {{< accordionItem title="Markdown example" open=true >}}
+  This item demonstrates Markdown rendering:
+  - **Bold text**
+  - Lists
+  - `inline code`
   {{< /accordionItem >}}
 
-  {{< accordionItem title="Can I use Markdown?" md=false >}}
-  Yes. Content inside items is Markdown and supports other shortcodes like alerts:
+  {{< accordionItem title="Shortcode example" md=false >}}
+  This item demonstrates shortcode rendering with <code>md=false</code>:
   
   {{< alert >}}This is an inline alert.{{< /alert >}}
   {{< /accordionItem >}}