update accordion page (#941)

Author: ethanpalm

components/accordions.mdx

@@ -1,9 +1,13 @@
 ---
 title: "Accordions"
-description: "A dropdown component to toggle content visibility"
+description: "Collapsible components to show and hide content"
 icon: "chevron-down"
 ---
 
+Accordions allow users to expand and collapse content sections. Use accordions for progressive disclosure and to organize information.
+
+## Single accordion
+
 <Accordion title="I am an Accordion.">
   You can put any content in here, including other components, like code:
    ```java HelloWorld.java
@@ -15,9 +19,7 @@ icon: "chevron-down"
     ```
 </Accordion>
 
-<RequestExample>
-
-````mdx Accordion Example
+````mdx Accordion example
 <Accordion title="I am an Accordion.">
   You can put any content in here, including other components, like code:
 
@@ -31,9 +33,12 @@ icon: "chevron-down"
 </Accordion>
 ````
 
-````mdx Accordion Group Example
+## Accordion Groups
+
+Group related accordions together using `<AccordionGroup>`. This creates a cohesive section of accordions that can be individually expanded or collapsed.
+
 <AccordionGroup>
-  <Accordion title="FAQ without Icon">
+  <Accordion title="Getting started">
     You can put other components inside Accordions.
 
     ```java HelloWorld.java
@@ -43,23 +48,42 @@ icon: "chevron-down"
         }
     }
     ```
+  </Accordion>
+
+  <Accordion title="Advanced features" icon="bot">
+    Add icons to make accordions more visually distinct and scannable.
+  </Accordion>
+  
+  <Accordion title="Troubleshooting">
+    Keep related content organized into groups.
+  </Accordion>
+</AccordionGroup>
+
+````mdx Accordion Group Example
+<AccordionGroup>
+  <Accordion title="Getting started">
+    You can put other components inside Accordions.
 
-    Check out the [Accordion](/components/accordions) docs for all the supported props.
+    ```java HelloWorld.java
+    class HelloWorld {
+        public static void main(String[] args) {
+            System.out.println("Hello, World!");
+        }
+    }
+    ```
   </Accordion>
 
-  <Accordion title="FAQ with Icon" icon="alien-8bit">
-    Check out the [Accordion](/components/accordions) docs for all the supported props.
+  <Accordion title="Advanced features" icon="alien-8bit">
+    Add icons to make accordions more visually distinct and scannable.
   </Accordion>
 
-  <Accordion title="FAQ without Icon">
-    Check out the [Accordion](/components/accordions) docs for all the supported props.
+  <Accordion title="Troubleshooting">
+    Keep related content organized into groups.
   </Accordion>
 </AccordionGroup>
 ````
 
-</RequestExample>
-
-### Props
+## Properties
 
 <ResponseField name="title" type="string" required>
   Title in the Accordion preview.
@@ -75,39 +99,9 @@ icon: "chevron-down"
 
 <ResponseField name="icon" type="string or svg">
   A [Font Awesome icon](https://fontawesome.com/icons), [Lucide
-  icon](https://lucide.dev/icons), or SVG code
+  icon](https://lucide.dev/icons), or SVG code.
 </ResponseField>
 
 <ResponseField name="iconType" type="string">
-  One of "regular", "solid", "light", "thin", "sharp-solid", "duotone", or
-  "brands"
+  For Font Awesome icons, one of "regular", "solid", "light", "thin", "sharp-solid", "duotone", or "brands".
 </ResponseField>
-
-## Accordion Groups
-
-You can group multiple accordions into a single display. Simply add `<AccordionGroup>` around your existing `<Accordion>` components.
-
-<AccordionGroup>
-  <Accordion title="FAQ without Icon">
-    You can put other components inside Accordions.
-
-    ```java HelloWorld.java
-    class HelloWorld {
-        public static void main(String[] args) {
-            System.out.println("Hello, World!");
-        }
-    }
-    ```
-
-    Check out the [Accordion](/components/accordions) docs for all the supported props.
-
-  </Accordion>
-
-  <Accordion title="FAQ with Icon" icon="bot">
-    Check out the [Accordion](/components/accordions) docs for all the supported props.
-  </Accordion>
-  
-  <Accordion title="FAQ without Icon">
-    Check out the [Accordion](/components/accordions) docs for all the supported props.
-  </Accordion>
-</AccordionGroup>