Add doc pointers to the embed_video shortcode (#1549)

Author: caspark

.github/newsletter-issue-template.md

@@ -102,7 +102,9 @@ but here are the most important rules:
 - Only one image per section is allowed.
   - The maximum size is 300kb for static images and 2.5mb for GIFs.
   - The image should come before the text, and must have alt text for accessibility.
-  - Prefer static images to GIFs, to keep the page load times down.
+  - Prefer static images to GIFs/videos, to keep the page load times down.
+  - To include a video, encode it as `H.264` in an `mp4` container and use
+    the `embed_video()` shortcode; videos autoplay in a loop (muted).
 - Each section should be under 1000 characters, and under 6 paragraphs.
   - This only applies to the rendered text, not the markup.
 - Keep formatting minimal - no bold/italics/etc.
@@ -120,6 +122,10 @@ Please use these templates as a starting point:
     src="img"
     caption="optional image label") }}
 
+OR
+
+{{ embed_video(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}.
 
@@ -140,6 +146,10 @@ _Discussions: [/r/rust_gamedev](link), [Twitter](link), [etc](link)_
     src="img"
     caption="optional image label") }}
 
+OR
+
+{{ embed_video(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

@@ -55,6 +55,10 @@ Ideal section structure is:
     src="image link"
     caption="image caption") }}
 
+OR
+
+{{ embed_video(type="video/mp4", src="my-video.mp4", caption="optional video caption") }}
+
 A paragraph or two with a summary and [useful links].
 
 _Discussions:

CONTRIBUTING.md

@@ -2,10 +2,13 @@
 
 Thank you for contributing to the newsletter! 💖
 
-- [Writing Newsletter Sections](#writing-newsletter-sections)
-  - [Templates](#templates)
-  - [Style Guidelines](#style-guidelines)
-- [Becoming an Editor](#becoming-an-editor)
+- [Contributing Guide](#contributing-guide)
+  - [Writing Newsletter Sections](#writing-newsletter-sections)
+    - [Templates](#templates)
+      - [Games, Apps or Libraries](#games-apps-or-libraries)
+      - [Articles, Blog Posts or Videos](#articles-blog-posts-or-videos)
+    - [Style Guidelines](#style-guidelines)
+  - [Becoming an Editor](#becoming-an-editor)
 
 ## Writing Newsletter Sections
 
@@ -78,6 +81,10 @@ _Discussions: [/r/rust_gamedev](link), [Twitter](link), [etc](link)_
     src="img"
     caption="optional image label") }}
 
+OR
+
+{{ embed_video(type="video/mp4", src="my-video.mp4", caption="optional video caption") }}
+
 [@nickname] published an [article] about...
 {overview what the resource is about}.
 
@@ -100,11 +107,13 @@ _Discussions: [/r/rust_gamedev](link), [Twitter](link), [etc](link)_
 - Avoid having multiple/nested bullet points.
   - This guideline may be relaxed if your project has multiple parts that
     aren't independent enough for their own sections.
-- Only include one image (<300kb) or GIF (<2.5mb).
+- Only include one image (<300kb), GIF (<2.5mb) or video (<2.5mb).
   - Images should be placed before text, with an optional caption and
     mandatory alternate text for accessibility.
   - Unless essential to demonstrating your project, prefer static images
-    over GIFs, to keep the file size down.
+    over GIFs/videos, to keep the file size down.
+  - To include a video, encode it as `H.264` in an `mp4` container and use
+    the `embed_video()` shortcode; videos autoplay in a loop (muted).
 - Use singular 'they' if you’re not sure what someone's pronouns are.
 - If a project has been featured in previous newsletters, try to focus on
   what's new rather than repeating previous content.