third pass

Author: arthurchi93

fern/squads.mdx

@@ -19,10 +19,10 @@ 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.
+To use Squads, you can create a `squad` when starting a call and specify `members` as a list of assistants and destinations. Assistants can be either persistent or transient.
 
 <Info>
-The first member is the assistant that will start the call, and assistants can be either persistent or transient.
+The first member is the assistant that will start the call.
 </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). 
@@ -65,7 +65,7 @@ We recommend using [Handoff Tools](/tools/handoff) to specify which destinations
 ## Overrides
 
 ### Assistant Overrides
-To override the configuration of a saved assistant without modifying the underlying assistant, use the `assistantsOverrides` to alter individual assistants. For example, if you have disparate assistants with different voices, you can use `assistantOverrides` to make sure all of the assistants are using the same voice without changing the assistant (in case its being used in another squad). 
+To override the configuration of a saved assistant without modifying the underlying assistant, use the `assistantsOverrides` to alter individual assistants. For example, if you have assistants in a squad with different voices, you can use `assistantOverrides` to make sure all of the assistants are using the same voice without changing the assistant (in case it's being used in another squad). 
 
 ```json
 {
@@ -94,7 +94,7 @@ To override the configuration of a saved assistant without modifying the underly
 }
 ```
 
-You may also define inline tools via assistant overrides through the `model` object, so that the assistant will only handoff if it is a part of this squad.
+You may also define inline tools via assistant overrides through the `model` object (using `tools:append`), so that the assistant will only handoff if it is a part of this squad.
 ```json
 {
     "squad": {
@@ -136,9 +136,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`. 
+To override the configuration of _all_ assistants in a squad 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)
+Note: This is `squadOverrides` for the [`assistant-request`](api-reference/webhooks/server-message#response.body.messageResponse.AssistantRequest.squadOverrides) webhook response.
 </Info>
 
 ```json