From 6398ca9efe47a0647a35aa3296169ee8d5977ec4 Mon Sep 17 00:00:00 2001
From: Rachel Rigdon <60661988+rachel-rigdon-sp@users.noreply.github.com>
Date: Fri, 9 Dec 2022 07:52:56 -0600
Subject: [PATCH 1/3] Documentation (#4721)

replaced "in for you" with "in it for you"
---
 docs/insiders/index.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/docs/insiders/index.md b/docs/insiders/index.md
index 37cc91158..7f43af644 100644
--- a/docs/insiders/index.md
+++ b/docs/insiders/index.md
@@ -7,7 +7,7 @@ title: Insiders
 Material for MkDocs follows the __sponsorware__ release strategy, which means
 that new features are first exclusively released to sponsors as part of
 [Insiders]. Read on to learn [what sponsorships achieve],
-[how to become a sponsor] to get access to Insiders, and [what's in for you]!
+[how to become a sponsor] to get access to Insiders, and [what's in it for you]!
 
 <!-- <figure class="mdx-video" markdown>
   <div class="mdx-video__inner">
@@ -24,13 +24,13 @@ This documentation is built with Insiders
   [Insiders]: #what-is-insiders
   [what sponsorships achieve]: #what-sponsorships-achieve
   [how to become a sponsor]: #how-to-become-a-sponsor
-  [what's in for you]: #whats-in-for-me
+  [what's in it for you]: #whats-in-it-for-me
   [Material for MkDocs]: https://squidfunk.github.io/mkdocs-material/
 
 ## What is Insiders?
 
 Material for MkDocs Insiders is a private fork of Material for MkDocs, hosted as
-a private GitHub repository. Almost[^1] [all new features][what's in for you]
+a private GitHub repository. Almost[^1] [all new features][what's in it for you]
 are developed as part of this fork, which means that they are immediately
 available to all eligible sponsors, as they are made collaborators of this
 repository.
@@ -78,7 +78,7 @@ a handful of them, [thanks to our awesome sponsors]!
   [completed funding goals]: #goals-completed
   [thanks to our awesome sponsors]: #how-to-become-a-sponsor
 
-## What's in for me?
+## What's in it for me?
 
 The moment you [become a sponsor][how to become a sponsor], you'll get __immediate
 access to 19 additional features__ that you can start using right away, and

From 9827e261b91955f9106d0d4ac8f04ec3ca4cc016 Mon Sep 17 00:00:00 2001
From: TetraTheta <37061801+TetraTheta@users.noreply.github.com>
Date: Sat, 10 Dec 2022 20:18:47 +0900
Subject: [PATCH 2/3] Added 'yaml.customTags' to 'settings.json' example
 (#4723)

* Add 'yaml.customTags' to 'settings.json' example

in 'Creating Your Site'

* Grammar edit

* Use code annotation
---
 docs/creating-your-site.md | 11 +++++++++--
 1 file changed, 9 insertions(+), 2 deletions(-)

diff --git a/docs/creating-your-site.md b/docs/creating-your-site.md
index c8123802b..c9893accc 100644
--- a/docs/creating-your-site.md
+++ b/docs/creating-your-site.md
@@ -58,14 +58,21 @@ theme:
         2.  Add the schema under the `yaml.schemas` key in your user or
             workspace [`settings.json`][settings.json]:
 
-            ``` json
+            ``` { .json .annotate }
             {
               "yaml.schemas": {
                 "https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml"
-              }
+              },
+              "yaml.customTags": [ // (1)!
+                "tag:yaml.org,2002:python/name:materialx.emoji.to_svg",
+                "tag:yaml.org,2002:python/name:materialx.emoji.twemoji",
+                "tag:yaml.org,2002:python/name:pymdownx.superfences.fence_code_format"
+              ]
             }
             ```
 
+            1. `yaml.customTags` part will be needed if you want to use and configure [Emojis](reference/icons-emojis.md).
+
     === "Other"
 
         1.  Ensure your editor of choice has support for YAML schema validation.

From 397edd9ae9048470a71497cfd73b88dc8d9173a1 Mon Sep 17 00:00:00 2001
From: squidfunk <martin.donath@squidfunk.com>
Date: Sat, 10 Dec 2022 12:37:41 +0100
Subject: [PATCH 3/3] Documentation

---
 docs/creating-your-site.md | 10 ++++++----
 1 file changed, 6 insertions(+), 4 deletions(-)

diff --git a/docs/creating-your-site.md b/docs/creating-your-site.md
index c9893accc..4a4971c48 100644
--- a/docs/creating-your-site.md
+++ b/docs/creating-your-site.md
@@ -58,7 +58,7 @@ theme:
         2.  Add the schema under the `yaml.schemas` key in your user or
             workspace [`settings.json`][settings.json]:
 
-            ``` { .json .annotate }
+            ``` json
             {
               "yaml.schemas": {
                 "https://squidfunk.github.io/mkdocs-material/schema.json": "mkdocs.yml"
@@ -71,12 +71,13 @@ theme:
             }
             ```
 
-            1. `yaml.customTags` part will be needed if you want to use and configure [Emojis](reference/icons-emojis.md).
+            1.  This setting is necessary if you plan to use [icons and emojis],
+                or Visual Studio Code will show errors on certain lines.
 
     === "Other"
 
-        1.  Ensure your editor of choice has support for YAML schema validation.
-        2.  Add the following lines at the top of `mkdocs.yml`:
+        3.  Ensure your editor of choice has support for YAML schema validation.
+        4.  Add the following lines at the top of `mkdocs.yml`:
 
             ``` yaml
             # yaml-language-server: $schema=https://squidfunk.github.io/mkdocs-material/schema.json
@@ -96,6 +97,7 @@ theme:
   [extension]: https://github.com/squidfunk/mkdocs-material/tree/master/docs/schema/extensions
   [plugin]: https://github.com/squidfunk/mkdocs-material/tree/master/docs/schema/plugins
   [$ref]: https://json-schema.org/understanding-json-schema/structuring.html#ref
+  [icons and emojis]: reference/icons-emojis.md
 
 ### Advanced configuration