second pass

Author: arthurchi93

fern/squads.mdx

@@ -4,10 +4,10 @@ subtitle: Use Squads to handle complex workflows and tasks.
 slug: squads
 ---
 
-Squads let you break complex workflows into multiple specialized assistants that hand off to each other during a conversation. Each assistant in a Squad handles a specific part of your workflow—like one assistant for lead qualification that transfers to another for appointment booking.
+Squads let you break complex workflows into multiple specialized assistants that hand off to each other during a conversation. Each assistant in a Squad handles a specific part of your workflow; for example, one assistant for lead qualification that transfers to another for appointment booking.
 
 **Why use Squads?** Large, all-in-one assistants with lengthy prompts and extensive context lead to:
-- **Higher hallucination rates** - Models lose focus with too many and sometimes conflicting instructions
+- **Higher hallucination rates** - Models lose focus with too many and potentially conflicting instructions
 - **Increased costs** - Longer prompts consume more tokens per request
 - **Greater latency** - Processing large contexts takes more time and will increase the latency of your assistant.
 
@@ -20,14 +20,14 @@ Squads solve this by splitting complex prompts into focused assistants with spec
 ## Usage
 
 To use Squads, you can create a `squad` when starting a call and specify `members` as a list of assistants and destinations.
+
+<Info>
 The first member is the assistant that will start the call, and assistants can be either persistent or transient.
+</Info>
 
 We recommend using [Handoff Tools](/tools/handoff) to specify which destinations the current assistant can handoff too, and when to handoff to each assistant. Each assistant within the squad can use its saved handoff tools as well as handoff tools from Assistant Overrides (see below). 
 
 
-<!-- Each assistant should be assigned the relevant assistant transfer destinations.
-Transfers are specified by assistant name and are used when the model recognizes a specific trigger. -->
-
 ```json
 {
     "squad": {
@@ -137,6 +137,9 @@ You may also define inline tools via assistant overrides through the `model` obj
 
 ### Member Overrides
 To override the configuration of _all_ assistants without modifying the underlying assistants, use the `memberOverrides`. 
+<Info>
+Note: This is `squadOverrides` for [`assistant-request`](api-reference/webhooks/server-message#response.body.messageResponse.AssistantRequest.squadOverrides)
+</Info>
 
 ```json
 {