diff --git a/exampleSite/content/samples/rich-content.md b/exampleSite/content/samples/rich-content.md
index 6772ec7d..aa200085 100755
--- a/exampleSite/content/samples/rich-content.md
+++ b/exampleSite/content/samples/rich-content.md
@@ -6,24 +6,30 @@ summary: "This is an _example_ of a **rich** content summary."
 tags: ["shortcodes", "privacy", "sample"]
 ---
 
-Hugo ships with several [Built-in Shortcodes](https://gohugo.io/content-management/shortcodes/#use-hugos-built-in-shortcodes) for rich content, along with a [Privacy Config](https://gohugo.io/about/hugo-and-gdpr/) and a set of Simple Shortcodes that enable static and no-JS versions of various social media embeds.
+Hugo ships with several [built-in shortcodes](https://gohugo.io/content-management/shortcodes/#use-hugos-built-in-shortcodes) for rich content, along with a [privacy config](https://gohugo.io/about/hugo-and-gdpr/) and a set of _simple shortcodes_ that enable static and no-JS versions of various social media embeds.
 
-## YouTube Privacy Enhanced Shortcode
+## YouTube
+
+Below is an example using the built-in `youtube` shortcode.
 
 {{< youtube ZJthWmvUzzc >}}
 
-<br>
+## Twitter
 
----
-
-## Twitter Simple Shortcode
+This example uses the `twitter_simple` shortcode to output a Tweet. It requires two named parameters `user` and `id`.
 
 {{< twitter_simple user="DesignReviewed" id="1085870671291310081" >}}
 
-<br>
+Alternatively, the `tweet` shortcode can be used to embed a fully marked up Twitter card.
 
----
+## Gist
 
-## Vimeo Simple Shortcode
+The `gist` shortcode can be used to embed a GitHub Gist. It requires two unnamed parameters: the username and ID of the Gist.
+
+{{< gist jpanther a873e1219ffeaa80a926bbe8255f348e >}}
+
+## Vimeo
+
+The `vimeo_simple` shortcode will embed a Vimeo video.
 
 {{< vimeo_simple 48912912 >}}