Update theme docs

Author: handotdev

core-concepts/themes.mdx

@@ -6,21 +6,21 @@ icon: "paint-bucket"
 
 import { ThemeCard } from "/snippets/theme-card.mdx";
 
-We offer pre-built themes so you can differentiate the look and feel of your documentation based on your brand.
+The platform supports a variety of pre-built themes so you can tailor the look and feel of your documentation based on your brand.
 
 ## Configuration
 
-You can configure the theme in the `docs.json` file.
+You can configure the theme property in [docs.json](/core-concepts/settings#param-theme).
 
-For example, to use the `maple` theme, you can add the following to your `docs.json` file:
+For example, to use the `maple` theme, you can add the following:
 
 ```json
 {
   "theme": "maple"
 }
 ```
 
-## Available Themes
+## Themes
 
 There are a variety of themes to choose from.
 

image-embeds.mdx

@@ -9,14 +9,11 @@ icon: 'image'
   src="https://mintlify-assets.b-cdn.net/bigbend.jpg"
 />
 
-<Info>
-  Mintlify supports files up to 5 MB. To use larger files, consider a storage
-  service like Cloudinary and embed in your documentation using the URL.
-</Info>
-
 ## Image
 
-### Using Markdown
+Images are the most common way to add visual content to your documentation.
+
+### Basics
 
 The [markdown syntax](https://www.markdownguide.org/basic-syntax/#images) lets you add images using the following code
 
@@ -26,9 +23,10 @@ The [markdown syntax](https://www.markdownguide.org/basic-syntax/#images) lets y
 <Tip>
 To make sure images are displayed correctly in production, add a forward slash to the image path (e.g. `/path/image.jpg`).
 </Tip>
-Note that the image file size must be less than 5MB. Otherwise, we recommend hosting on a service like [Cloudinary](https://cloudinary.com/) or [S3](https://aws.amazon.com/s3/). You can then use that URL and embed.
 
-### Using Embeds
+Note that the image file size must be less than 20MB. Otherwise, we recommend hosting on a CDN provider like [S3](https://aws.amazon.com/s3), [Cloudinary](https://cloudinary.com) or a similar service.
+
+### Embeds
 
 To get more customizability with images, you can also use embeds to add images.
 
@@ -144,8 +142,3 @@ Loads another HTML page within the document.
 <iframe src="https://www.youtube.com/embed/4KzFe50RQkQ"> </iframe>
 ```
 
-<Tip>
-  Although not required, we recommend adding the `alt` and `title` attributes to
-  images for better SEO and accessability. Learn more at [image
-  SEO](https://yoast.com/image-seo-alt-tag-and-title-tag-optimization/).
-</Tip>

text.mdx

@@ -20,11 +20,9 @@ Best used for subsection headers.
 ### Subtitles
 ```
 
-<Tip>
-
-Each **title** and **subtitle** creates an anchor and also shows up on the table of contents on the right.
-
-</Tip>
+<Info>
+  Titles and subtitles create anchors and also show up on the table of contents on the right.
+</Info>
 
 ## Text Formatting