diff --git a/markdown/dev/guides/content/en.md b/markdown/dev/guides/content/en.md
new file mode 100644
index 00000000000..127c95c4340
--- /dev/null
+++ b/markdown/dev/guides/content/en.md
@@ -0,0 +1,3 @@
+---
+title: Content guides
+---
diff --git a/markdown/dev/guides/content/mdx/en.md b/markdown/dev/guides/content/mdx/en.md
new file mode 100644
index 00000000000..3a4dd133915
--- /dev/null
+++ b/markdown/dev/guides/content/mdx/en.md
@@ -0,0 +1,5 @@
+---
+title: MDX Guide
+---
+
+Explain MDX content
diff --git a/markdown/dev/guides/content/sanity/en.md b/markdown/dev/guides/content/sanity/en.md
new file mode 100644
index 00000000000..0816e8fd903
--- /dev/null
+++ b/markdown/dev/guides/content/sanity/en.md
@@ -0,0 +1,70 @@
+---
+title: Sanity Content Guide
+---
+
+FreeSewing uses Sanity content needs to be edited/written by non-technical contributors,
+and for images uploaded by users, such as for their profile image and so on.
+
+
+
+You can manage FreeSewing's Sanity content at
+[cms.freesewing.org](https://cms.freesewing.org/)
+
+
+By *content that needs to be edited/written by non-technical contributors* we mean:
+
+- Newsletter posts
+- Blog posts in all languages
+- Showcase posts in all languages
+
+## Why we use Sanity
+
+The (historical) reason that we use a (headless) CMS for this lies with **the
+showcase posts**. Our documentation is still hosted in git as MDX, and
+historically this was also the case for our blog posts and showcase posts.
+
+However, while documentation is written by contributors who are familiar with
+how we work, and blog posts are typically written by Joost, showcase posts are
+often provided by users of the site for whom submitting a pull request is a
+steep learning curve.
+
+So for this reason, we started using an external CMS to host the showcase
+posts. And, since blog posts and showcase posts are so similar, we decided to
+use this platform for both. Later, we added newsletter content to this list
+because this too is sometimes provided by people not so familiar with the git
+workflow.
+
+Prior to version 3, we used a self-hosted version of
+[Strapi](https://strapi.io/) for this. And while that did what we needed,
+self-hosting adds workload to people and our backend systems, so it's not
+without its drawbacks. Then, with the release of Strapi v4, they dropped
+support for MongoDB, which was the database we are using, so we were stuck on
+v3 of Strapi.
+
+So for FreeSewing v3 we started looking for alternatives, and after trying
+various solutions Sanity came out as the best solution for our needs. It's a
+SaaS solution -- which is nice because it means we don't have to host anything
+-- but the flip side of the coin is that as a communal open source project, we
+obviously cannot afford it.
+
+Fortunately for us, the same reasons that mean we don't have any money also
+mean that Sanity took pity on us, and they agreed to waive their fees and let
+us use their service free of charge. So, Sanity is now a FreeSewing sponsor,
+and since everything is in place already, we also use them to host user images
+because honestly it's a really nice service.
+
+## How to manage Sanity content
+
+As Sanity is a headless CMS, you essentially have to talk to the API to manage
+your content.
+
+Fear not though, we don't expect you to do that. The Sanity Studio is a
+web-based frontend that allows you to manage the content in a web environment,
+and we have an instance of it deployed at https://cms.freeseiwng.org/ that is
+pre-configured to manage FreeSewing's content.
+
+## For developers
+
+If you're looking to learn more about how to interact with the Sanity API,
+please refer to [the Sanity reference documentation](/reference/sites/sanity).
+
diff --git a/markdown/dev/reference/sites/en.md b/markdown/dev/reference/sites/en.md
new file mode 100644
index 00000000000..6240b657dd9
--- /dev/null
+++ b/markdown/dev/reference/sites/en.md
@@ -0,0 +1,5 @@
+---
+title: Sites
+---
+
+
diff --git a/markdown/dev/reference/sites/sanity/en.md b/markdown/dev/reference/sites/sanity/en.md
new file mode 100644
index 00000000000..b58da953778
--- /dev/null
+++ b/markdown/dev/reference/sites/sanity/en.md
@@ -0,0 +1,56 @@
+---
+title: Sanity
+---
+
+FreeSewing uses [Sanity](https://www.sanity.io/) -- a headless CMS, or a SaaS
+platform for structure content -- to host various types of content.
+
+For background information, please refer to [the Sanity content
+guide](/guides/content/sanity).
+
+## Content schema
+
+The Sanity content scheme is stored in `sites/sanity/schema` in our monorepo.
+
+## Sanity studio
+
+The `sites/sanity` folder holds an instance of Sanity Studio -- the frontend to
+manage the content -- preconfigured to work with our content. This site is
+published at https://cms.freesewing.org/ where editors can work on our content.
+
+### Authentication
+
+To be able to use the Sanity Studio with FreeSewing's data, you need to be
+added as an editor. Sanity supports using your GitHub account to authenticate,
+so if you want to become an editor, you can ask joost to grant you access.
+
+### Local development
+
+After setting up the monorepo with `yarn kickstart` in the root folder, change your working directoy to `sites/sanity` and run `yarn dev`:
+
+```sh
+git clone git@github.com:freesewing/freesewing.git
+cd freesewing
+yarn kickstart
+cd sites/sanity
+yarn dev
+```
+
+The Sanity Studio UI will open at http://localhost:3333
+
+
+This instance is setup to work with our production data.
+
+
+## Sanity API
+
+
+The following data is required to interact with Sanity:
+
+- Project ID: `hl5bw8cj`
+- Dataset: `production`
+
+With that and [the API reference
+documentation](https://www.sanity.io/docs/reference) you should be able to get
+started.
+
diff --git a/sites/shared/components/mdx/index.mjs b/sites/shared/components/mdx/index.mjs
index ce4e4c513a0..73eb01cd761 100644
--- a/sites/shared/components/mdx/index.mjs
+++ b/sites/shared/components/mdx/index.mjs
@@ -21,6 +21,7 @@ export const components = (site = 'org') => {
ReadMore: (props) => ,
Related: (props) => ,
Tip: (props) => ,
+ Tldr: (props) => ,
Warning: (props) => ,
YouTube,
pre: (props) => ,
diff --git a/sites/shared/components/popout.mjs b/sites/shared/components/popout.mjs
index ddea54a8784..93434a62230 100644
--- a/sites/shared/components/popout.mjs
+++ b/sites/shared/components/popout.mjs
@@ -11,6 +11,7 @@ const colors = {
fixme: 'warning',
link: 'secondary',
related: 'info',
+ tldr: 'info',
none: '',
}
@@ -64,7 +65,9 @@ export const Popout = (props) => {
>