mintlify · tiffany-mintlify · Feb 25, 2025
diff --git a/content-types.mdx b/content-types.mdx
@@ -7,6 +7,12 @@ description: 'Focus writing based on content type'
   In this article, you’ll learn the different content types, when to use each one, and how to approach writing each type.
 </Tip>
 
+<img
+  src="/images/types.png"
+  alt="Person with floating blocks"
+  noZoom
+/>
+
 Documentation needs to be organized around the specific goal you're trying to help the user achieve. 
 
 ## Categorize using the Diataxis framework
@@ -20,9 +26,19 @@ The [Diataxis framework](https://diataxis.fr) is a helpful guide for categorizin
 
 Defining content types helps you plan documentation with a clear purpose and makes it easier for users to find what they need.
 
-<Frame>
-<img src="/images/diataxis.webp" />
-</Frame>
+
+<img
+  className="block dark:hidden"
+  src="/images/diataxis_light.png"
+  alt="Diataxis framework light mode"
+  noZoom
+/>
+<img
+  className="hidden dark:block"
+  src="/images/diataxis_dark.png"
+  alt="Diataxis framework dark mode"
+  noZoom
+/>
 ## Picking a type
 
 | Question                     | Tutorial             | How-To               | Reference            | Explanation          |

diff --git a/images/audience.png b/images/audience.png
diff --git a/images/diataxis.webp b/images/diataxis.webp
diff --git a/images/diataxis_dark.png b/images/diataxis_dark.png
diff --git a/images/diataxis_light.png b/images/diataxis_light.png
diff --git a/images/maintenance.png b/images/maintenance.png
diff --git a/images/media.png b/images/media.png
diff --git a/images/navigation.png b/images/navigation.png
diff --git a/images/types.png b/images/types.png
diff --git a/know-your-audience.mdx b/know-your-audience.mdx
@@ -7,6 +7,12 @@ description: 'Keep user goals at the center of your writing'
   This article covers how to identify your audience, conduct user research, and write with their needs in mind.
 </Tip>
 
+<img
+  src="/images/audience.png"
+  alt="People walking around office buildings"
+  noZoom
+/>
+
 ## Identify your primary audience
 
 Writing for multiple audiences leads to compromises that satisfy no one. Each piece of content should be laser-focused on one specific user persona.

diff --git a/maintenance.mdx b/maintenance.mdx
@@ -7,6 +7,12 @@ description: 'Tips for keeping docs up-to-date'
   This article covers strategies for keeping your documentation accurate and valuable over time, from automated checks to content lifecycles.
 </Tip>
 
+<img
+  src="/images/maintenance.png"
+  alt="Giant gear"
+  noZoom
+/>
+
 ### **Automate what you can**
 
 Documentation rot happens when you rely too much on manual effort to update content. 

diff --git a/media.mdx b/media.mdx
@@ -7,6 +7,12 @@ description: 'Guidelines for incorporating media'
   This article covers guidelines for how to use screenshots, GIFs, and videos in your documentation.
 </Tip>
 
+<img
+  src="/images/media.png"
+  alt="Stairs and a phone screen"
+  noZoom
+/>
+
 Screenshots, GIFs, and videos can enhance documentation but require ongoing maintenance as UI elements change. Use them selectively to avoid unnecessary upkeep.
 
 Key guidelines:

diff --git a/navigation.mdx b/navigation.mdx
@@ -2,8 +2,15 @@
 title: 'Organizing Navigation'
 description: 'Guidelines for information hierarchy'
 ---
-
-This article covers why and how to organize your information hierarchy in a way that makes sense for your users. 
+<Tip>
+This article covers how to organize your information hierarchy in a way that makes sense for your users. 
+</Tip>
+
+<img
+  src="/images/navigation.png"
+  alt="Hallway with trees"
+  noZoom
+/>
 
 ## Why is navigation important?