VAP-3003: [Docs] Restructure top-level sidebar categories to align with new dashboard information hierarchy

fern/GHL.mdx

@@ -1,6 +1,6 @@
 ---
 title: How to Connect Vapi with Make & GHL
-slug: GHL
+slug: tools/GHL
 ---
 
 

fern/assistants.mdx

@@ -4,10 +4,58 @@ subtitle: The core building-block of voice agents on Vapi.
 slug: assistants
 ---
 
+**Assistant** is a fancy word for an AI configuration that can be used across phone calls and Vapi clients. Your voice assistant can augment your customer support and 
+experience for call centers, business websites, mobile apps, and much more.
 
-**Assistant** is a fancy word for an AI configuration that can be used across phone calls and Vapi clients. Your voice assistant can augment your customer support and experience for call centers, business websites, mobile apps, and much more.
+## Core Components
 
-There are three core components: **Transcriber**, **Model**, and **Voice**. These can be configured, mixed, and matched for your use case. <br /> <Info> There are also various other configurable properties you can find [here](/api-reference/assistants/create-assistant) </Info> Below, check out some ways you can layer in powerful customizations and features to meet any use case.
+There are three core components that make up an assistant:
+
+- **Transcriber**: Converts spoken audio into text
+- **Model**: The AI model that processes the text and generates responses
+- **Voice**: The voice that speaks the AI's responses
+
+These components can be configured, mixed, and matched for your specific use case.
+
+<Info>
+  View all configurable properties in the [API Reference](/api-reference/assistants/create-assistant)
+</Info>
+
+## Key Features
+
+### Dynamic Variables
+Personalize your assistant's responses using variables that can be customized for each call. This allows you to:
+- Insert dynamic content like dates, times, and user information
+- Customize greetings and responses
+- Maintain context across conversations
+
+### Call Analysis 
+Get detailed insights into each conversation through:
+- Call summaries
+- Structured data extraction
+- Success evaluation metrics
+- Custom analysis rubrics
+
+### Persistence Options
+Choose between:
+- **Persistent Assistants**: Reusable configurations stored via the `/assistant` endpoint
+- **Temporary Assistants**: One-time configurations specified when starting a call
+
+## Prompting Best Practices
+
+Effective prompt engineering is crucial for creating successful voice AI agents. Learn how to:
+- Structure prompts for voice interactions
+- Add personality and natural speech patterns
+- Handle errors gracefully
+- Improve response quality
+
+<Card
+  title="Voice AI Prompting Guide"
+  icon="book"
+  href="/prompting-guide"
+>
+  Learn best practices for engineering voice AI prompts
+</Card>
 
 ## Advanced Concepts