Unify shortcode examples

Author: tautropfli

.github/newsletter-issue-template.md

@@ -118,13 +118,16 @@ Please use these templates as a starting point:
 ### [Game name]
 
 {{ image_figure(
-    alt="alt text"
-    src="img"
-    caption="optional image label") }}
+    alt="image/GIF description",
+    src="image link",
+    caption="image caption") }}
 
 OR
 
-{{ video_figure(type="video/mp4", src="my-video.mp4", caption="optional video caption") }}
+{{ video_figure(
+    type="video/mp4", 
+    src="my-video.mp4", 
+    caption="optional video caption") }}
 
 [Game name] ([GitHub], [Discord], [Twitter]) by [@nickname]
 is... {short project description in one sentence}.
@@ -142,13 +145,16 @@ _Discussions: [/r/rust_gamedev](link), [Twitter](link), [etc](link)_
 ### [Article name]
 
 {{ image_figure(
-    alt="alt text"
-    src="img"
-    caption="optional image label") }}
+    alt="image/GIF description",
+    src="image link",
+    caption="image caption") }}
 
 OR
 
-{{ video_figure(type="video/mp4", src="my-video.mp4", caption="optional video caption") }}
+{{ video_figure(
+    type="video/mp4", 
+    src="my-video.mp4", 
+    caption="optional video caption") }}
 
 [@nickname] published an [article] about...
 {overview what the resource is about}.

.github/newsletter-template.md

@@ -51,13 +51,16 @@ Ideal section structure is:
 ### [Title]
 
 {{ image_figure(
-    alt="image/GIF description"
-    src="image link"
+    alt="image/GIF description",
+    src="image link",
     caption="image caption") }}
 
 OR
 
-{{ video_figure(type="video/mp4", src="my-video.mp4", caption="optional video caption") }}
+{{ video_figure(
+    type="video/mp4", 
+    src="my-video.mp4", 
+    caption="optional video caption") }}
 
 A paragraph or two with a summary and [useful links].
 

CONTRIBUTING.md

@@ -57,9 +57,16 @@ your GitHub notifications for any further review comments from the editors.
 ### [Game name]
 
 {{ image_figure(
-    alt="alt text"
-    src="img"
-    caption="optional image label") }}
+    alt="image/GIF description",
+    src="image link",
+    caption="image caption") }}
+
+OR
+
+{{ video_figure(
+    type="video/mp4", 
+    src="my-video.mp4", 
+    caption="optional video caption") }}
 
 [Game name] ([GitHub], [Discord], [Twitter]) by [@nickname]
 is... {short project description in one sentence}.
@@ -77,13 +84,16 @@ _Discussions: [/r/rust_gamedev](link), [Twitter](link), [etc](link)_
 ### [Article name]
 
 {{ image_figure(
-    alt="alt text"
-    src="img"
-    caption="optional image label") }}
+    alt="image/GIF description",
+    src="image link",
+    caption="image caption") }}
 
 OR
 
-{{ video_figure(type="video/mp4", src="my-video.mp4", caption="optional video caption") }}
+{{ video_figure(
+    type="video/mp4", 
+    src="my-video.mp4", 
+    caption="optional video caption") }}
 
 [@nickname] published an [article] about...
 {overview what the resource is about}.

content/news/053/index.md

@@ -51,10 +51,17 @@ Ideal section structure is:
 ### [Title]
 
 {{ image_figure(
-    alt="image/GIF description"
-    src="image link"
+    alt="image/GIF description",
+    src="image link",
     caption="image caption") }}
 
+OR
+
+{{ video_figure(
+    type="video/mp4", 
+    src="my-video.mp4", 
+    caption="optional video caption") }}
+
 A paragraph or two with a summary and [useful links].
 
 _Discussions:
@@ -77,8 +84,8 @@ If needed, a section can be split into subsections with a "------" delimiter.
 ### [Chuột][chuot-website]
 
 {{ image_figure(
-    alt="Bunnymark example"
-    src="chuot.png"
+    alt="Bunnymark example",
+    src="chuot.png",
     caption="[Bunnymark example](https://tversteeg.nl/chuot/examples/bunnymark/)") }}
 
 Chuột ([Website][chuot-website], [GitHub][chuot-github]) by [@tversteeg]