fix(debugging): formatting issues

Author: goosewin

fern/debugging.mdx

@@ -8,12 +8,19 @@ slug: debugging
 
 Voice agents involve multiple AI systems working together—speech recognition, language models, and voice synthesis. When something goes wrong, systematic debugging helps you quickly identify and fix the root cause.
 
-**Common debugging scenarios:**
-- Agent doesn't understand user input correctly
-- Responses are inappropriate or inconsistent  
-- Call quality issues or audio problems
-- Tool integrations failing or returning errors
-- Workflow logic not executing as expected
+**Most common issues fall into these categories:**
+
+<CardGroup cols={2}>
+  <Card title="Speech & Understanding" icon="microphone">
+    * Agent doesn't understand user input correctly
+    * Responses are inappropriate or inconsistent
+  </Card>
+  <Card title="Technical & Integration" icon="gear">
+    * Call quality issues or audio problems
+    * Tool integrations failing or returning errors
+    * Workflow logic not executing as expected
+  </Card>
+</CardGroup>
 
 ## Quick diagnostics
 
@@ -23,36 +30,59 @@ Start with these immediate checks before diving deeper:
   <Step title="Test in dashboard">
     Test your voice agent directly in the [dashboard](https://dashboard.vapi.ai/):
 
-    - **Assistants**: `Dashboard > Assistants > [Select Assistant] > Talk to Assistant`
-    - **Workflows**: `Dashboard > Workflows > [Select Workflow] > Call`
+    <CardGroup cols={2}>
+      <Card title="Assistants" icon="robot">
+        `Dashboard > Assistants > [Select Assistant] > Talk to Assistant`
+      </Card>
+      <Card title="Workflows" icon="diagram-project">
+        `Dashboard > Workflows > [Select Workflow] > Call`
+      </Card>
+    </CardGroup>
+    
+    **Benefits:**
     - Eliminates phone network variables
-    - Provides real-time transcript view
+    - Provides real-time transcript view  
     - Shows tool execution results immediately
   </Step>
   <Step title="Check logs">
     Navigate to the `Observe` section in your [dashboard](https://dashboard.vapi.ai/) sidebar:
 
-    - **Call Logs**: Review call transcripts, durations, and error messages
-    - **API Logs**: Check API requests and responses for integration issues  
-    - **Webhook Logs**: Verify webhook deliveries and server responses
+    <CardGroup cols={3}>
+      <Card title="Call Logs" icon="phone">
+        Review call transcripts, durations, and error messages
+      </Card>
+      <Card title="API Logs" icon="code">
+        Check API requests and responses for integration issues
+      </Card>
+      <Card title="Webhook Logs" icon="webhook">
+        Verify webhook deliveries and server responses
+      </Card>
+    </CardGroup>
   </Step>
   <Step title="Test individual components">
     Use [dashboard](https://dashboard.vapi.ai/) testing features:
 
-    - **Voice Test Suites**: `Test > Voice Test Suites` (assistants only)
-    - **Tool Testing**: `Tools > [Select Tool] > Test` with sample payloads
+    <CardGroup cols={2}>
+      <Card title="Voice Test Suites" icon="vial">
+        `Test > Voice Test Suites` (assistants only)
+      </Card>
+      <Card title="Tool Testing" icon="wrench">
+        `Tools > [Select Tool] > Test` with sample payloads
+      </Card>
+    </CardGroup>
   </Step>
   <Step title="Verify provider status">
     Check if AI service providers are experiencing issues:
 
+    **Core Services:**
     - Visit [Vapi Status Page](https://status.vapi.ai/) for Vapi service status
-    - Check provider status pages for specific services:
-      - [OpenAI Status](https://status.openai.com/) for OpenAI language models
-      - [Anthropic Status](https://status.anthropic.com/) for Anthropic language models
-      - [ElevenLabs Status](https://status.elevenlabs.io/) for ElevenLabs voice synthesis
-      - [Deepgram Status](https://status.deepgram.com/) for Deepgram speech-to-text
-      - And other providers' status pages as needed
-    - Review for ongoing maintenance or outages
+    
+    **Provider Status Pages:**
+    - [OpenAI Status](https://status.openai.com/) for OpenAI language models
+    - [Anthropic Status](https://status.anthropic.com/) for Anthropic language models  
+    - [ElevenLabs Status](https://status.elevenlabs.io/) for ElevenLabs voice synthesis
+    - [Deepgram Status](https://status.deepgram.com/) for Deepgram speech-to-text
+    - And other providers' status pages as needed
   </Step>
 </Steps>