Update icons docs (#818)

* Documentation edits made through Mintlify web editor

* Documentation edits made through Mintlify web editor

* Documentation edits made through Mintlify web editor

* Documentation edits made through Mintlify web editor

* Documentation edits made through Mintlify web editor

* Documentation edits made through Mintlify web editor

* fix formatting

Author: ethanpalm

components/icons.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Icons"
 description: "Use icons from popular icon libraries"
-icon: 'flag'
+icon: "flag"
 ---
 
 <Icon icon="flag" size={32} />
@@ -11,22 +11,23 @@ icon: 'flag'
 ```mdx Icon Example
 <Icon icon="flag" size={32} />
 ```
+
 </RequestExample>
 
 ## Inline Icons
 
 The icon will be placed inline when used in a paragraph.
 
 ```markdown Inline Icon Example
-<Icon icon="flag" iconType="solid" /> The documentation you want, effortlessly 
+<Icon icon="flag" iconType="solid" /> The documentation you want, effortlessly. 
 ```
 
-<Icon icon="flag" iconType="solid" /> The documentation you want, effortlessly
+<Icon icon="flag" iconType="solid" /> The documentation you want, effortlessly.
 
 ### Props
 
 <ResponseField name="icon" type="string" required>
-  A [Font Awesome](https://fontawesome.com/icons) or [Lucide](https://lucide.dev/icons) icon
+  A [Font Awesome](https://fontawesome.com/icons) icon, [Lucide](https://lucide.dev/icons) icon, URL to an icon, or relative path to an icon.
 </ResponseField>
 
 <ResponseField name="iconType" type="string">
@@ -39,4 +40,4 @@ The icon will be placed inline when used in a paragraph.
 
 <ResponseField name="size" type="number">
   The size of the icon in pixels
-</ResponseField>
+</ResponseField>

navigation.mdx

@@ -9,7 +9,7 @@ The [navigation](settings#param-navigation) property in [docs.json](settings) de
 With proper navigation configuration, you can organize your content into a logical hierarchy that makes it easy for users to find exactly what they're looking for.
 
 <Info>
-Do not use `api` as a title for any navigation element. The `/api` path is reserved in production and will cause pages to return 404 errors if their URLs contain `/api`.
+  Do not use `api` as a title for any navigation element. The `/api` path is reserved in production and will cause pages to return 404 errors if their URLs contain `/api`.
 </Info>
 
 ## Pages
@@ -45,7 +45,7 @@ Pages is an array where each entry must be a reference to the path of a [page fi
 
 ## Groups
 
-Use groups to organize your navigation into sections. Groups can be nested within each other and labeled with tags.
+Use groups to organize your navigation into sections. Groups can be nested within each other, labeled with tags, and styled with icons.
 
 <img
   className="block dark:hidden pointer-events-none"
@@ -63,15 +63,18 @@ Use groups to organize your navigation into sections. Groups can be nested withi
     "groups": [
       {
         "group": "Getting Started",
+		"icon": "play",
         "pages": [
           "quickstart",
           {
             "group": "Editing",
+			"icon": "pencil",
             "pages": [
 				"installation",
 				"editor",
 				{
 					"group": "Nested group",
+					"icon": "code",
 					"pages": [
 						"navigation",
 						"code"
@@ -83,6 +86,7 @@ Use groups to organize your navigation into sections. Groups can be nested withi
       },
       {
         "group": "Writing Content",
+ 		"icon": "notebook-text",
         "tag": "NEW",
         "pages": ["writing-content/page", "writing-content/text"]
       }
@@ -516,4 +520,4 @@ This way, you can create a very complex navigation structure that is easy to man
 }
 ```
 
-</CodeGroup>
+</CodeGroup>

pages.mdx

@@ -1,7 +1,7 @@
 ---
 title: "Pages"
 description: "Pages are the building blocks of your documentation"
-icon: 'letter-text'
+icon: "letter-text"
 ---
 
 ## Basics
@@ -39,7 +39,7 @@ sidebarTitle: "Short title"
 
 ## Icons
 
-You can set an icon for your sidebar item like the one for this page. You can set icons by using the `icon` metadata.
+Add an icon next to your page's sidebar title by including the `icon` field in your page's frontmatter.
 
 ```mdx
 ---
@@ -48,9 +48,9 @@ icon: "code"
 ---
 ```
 
-You can set icons from [Font Awesome](https://fontawesome.com/icons) and [Lucide](https://lucide.dev/icons), depending on the [icon library setting](settings#param-icons).
+You can set icons from a URL, [Font Awesome](https://fontawesome.com/icons), or [Lucide](https://lucide.dev/icons). Choose your preferred icon library (Font Awesome or Lucide) with the [icon library setting](settings#param-icons).
 
-You can also set the icon type for Font Awesome icons (optional). If not set, the icon type will be regular.
+For Font Awesome icons, you can optionally set the icon type. If not set, the icon type will be regular.
 
 ```mdx
 ---
@@ -116,7 +116,6 @@ Custom Mode provides a minimalist layout by removing all elements except for the
 This mode offers a blank canvas, which is ideal for creating a "landing page" or any page where
 you want a clean, distraction-free environment.
 
-
 ```mdx
 ---
 mode: "custom"
@@ -128,7 +127,6 @@ mode: "custom"
 Center Mode removes the sidebar and the table of contents, and centers the page content. This mode is great for changelogs
 or any page where you want to focus on the content.
 
-
 ```mdx
 ---
 mode: "center"
@@ -172,4 +170,4 @@ content or in search results, but users that search for them will be shown the p
 ---
 keywords: ['search', 'indexing']
 ---
-```
+```

settings.mdx

@@ -224,12 +224,13 @@ This section contains the full reference for the docs.json file.
 
       <Expandable title="Links">
         <ResponseField name="label" type="string" required>
+          The display text for a link.
         </ResponseField>
         <ResponseField name="href" type="string (uri)" required>
-          A valid path or external link
+          A valid path or external link.
         </ResponseField>
         <ResponseField name="icon" type="string | object">
-          The icon to be displayed in the navbar.
+          The icon displayed for a link. Can be a URL, Font Awesome icon, or Lucide icon.
         </ResponseField>
       </Expandable>
     </ResponseField>