Added documentation on how to use Mermaid in MDX.

Author: antonpirker

docs/contributing/pages/charts-diagrams.mdx

@@ -0,0 +1,23 @@
+---
+title: Charts & Diagrams
+noindex: true
+sidebar_order: 30
+---
+
+You can render charts and diagrams in you MDX files using [Mermaid](https://mermaid.js.org):
+
+````txt {tabTitle:Example}
+```mermaid
+flowchart TD
+  Start --> Stop
+```
+````
+
+Will turn into this:
+
+```mermaid
+flowchart TD
+    Start --> Stop
+```
+
+See the [Mermaid documentation](https://mermaid.js.org/intro/) to learn what types of charts and diagrams can be rendered.

docs/contributing/pages/components.mdx

@@ -1,6 +1,7 @@
 ---
 title: MDX Components
 noindex: true
+sidebar_order: 40
 ---
 
 ## Alert

docs/contributing/pages/frontmatter.mdx

@@ -1,6 +1,7 @@
 ---
 title: Frontmatter
 noindex: true
+sidebar_order: 10
 ---
 
 Frontmatter a YAML-formatted blob defined at the top of every markdown or mdx file:
@@ -55,5 +56,3 @@ Overrides the next page shown in the bottom pagination navigation.
 `previousPage` (`{ path: 'path/to/page', title: 'Page Title' }`)
 
 Overrides the previous page shown in the bottom pagination navigation.
-
-

docs/contributing/pages/images.mdx

@@ -1,6 +1,7 @@
 ---
 title: Images
 noindex: true
+sidebar_order: 20
 ---
 
 If you want to add images to your docs, you can add them in a `./img` folder in the same directory as your `.mdx` files.

docs/contributing/pages/redirects.mdx

@@ -1,6 +1,7 @@
 ---
 title: Redirects
 noindex: true
+sidebar_order: 60
 ---
 
 Redirects allow you to automatically redirect an incoming request path to a new destination path. When you move or rename a file, you should make sure to set up a redirect from the old path to the new path, so that the old URL still takes users to the right place.

docs/contributing/pages/search.mdx

@@ -1,6 +1,7 @@
 ---
 title: Search
 noindex: true
+sidebar_order: 70
 ---
 
 Search is powered by Algolia, and will index all content in `/docs/` that is Markdown or MDX formatted.

docs/contributing/pages/variables.mdx

@@ -1,6 +1,7 @@
 ---
 title: Markdown Variables
 noindex: true
+sidebar_order: 50
 ---
 
 A transformation is exposed to both Markdown and MDX files which supports processing variables in a Django/Jekyll-style way.