docs: Improve the Inline Assistant content (#41566)

Release Notes:

- N/A

docs/src/ai/agent-settings.md

@@ -54,15 +54,9 @@ You can assign distinct and specific models for the following AI-powered feature
 
 ### Alternative Models for Inline Assists {#alternative-assists}
 
-The Inline Assist feature in particular has the capacity to perform multiple generations in parallel using different models.
-That is possible by assigning more than one model to it, taking the configuration shown above one step further.
+With the Inline Assistant in particular, you can send the same prompt to multiple models at once.
 
-When configured, the inline assist UI will surface controls to cycle between the outputs generated by each model.
-
-The models you specify here are always used in _addition_ to your [default model](#default-model).
-
-For example, the following configuration will generate two outputs for every assist.
-One with Claude Sonnet 4 (the default model), and one with GPT-5-mini.
+Here's how you can customize your `settings.json` to add this functionality:
 
 ```json [settings]
 {
@@ -81,6 +75,34 @@ One with Claude Sonnet 4 (the default model), and one with GPT-5-mini.
 }
 ```
 
+When multiple models are configured, you'll see in the Inline Assistant UI buttons that allow you to cycle between outputs generated by each model.
+
+The models you specify here are always used in _addition_ to your [default model](#default-model).
+
+For example, the following configuration will generate three outputs for every assist.
+One with Claude Sonnet 4 (the default model), another with GPT-5-mini, and another one with Gemini 2.5 Flash.
+
+```json [settings]
+{
+  "agent": {
+    "default_model": {
+      "provider": "zed.dev",
+      "model": "claude-sonnet-4"
+    },
+    "inline_alternatives": [
+      {
+        "provider": "zed.dev",
+        "model": "gpt-4-mini"
+      },
+      {
+        "provider": "zed.dev",
+        "model": "gemini-2.5-flash"
+      }
+    ]
+  }
+}
+```
+
 ### Model Temperature
 
 Specify a custom temperature for a provider and/or model:
@@ -179,7 +201,7 @@ The default value is `false`.
 
 ### Message Editor Size
 
-Use the `message_editor_min_lines` setting to control minimum number of lines of height the agent message editor should have.
+Use the `message_editor_min_lines` setting to control the minimum number of lines of height the agent message editor should have.
 It is set to `4` by default, and the max number of lines is always double of the minimum.
 
 ```json [settings]
@@ -232,7 +254,7 @@ It is set to `true` by default, but if set to false, the card will be fully coll
 
 ### Feedback Controls
 
-Control whether to display the thumbs up/down buttons at the bottom of each agent response, allowing to give Zed feedback about the agent's performance.
+Control whether to display the thumbs up/down buttons at the bottom of each agent response, allowing you to give Zed feedback about the agent's performance.
 The default value is `true`.
 
 ```json [settings]