Update docs for some settings (#27474)

Junseong Park and Peter Tripp created

Fix incorrect defaults or descriptions and add missing content.

Release Notes:

- N/A

---------

Co-authored-by: Peter Tripp <peter@zed.dev>

Change summary

docs/src/configuring-zed.md | 120 ++++++++++++++++++++++++++++----------
1 file changed, 88 insertions(+), 32 deletions(-)

Detailed changes

docs/src/configuring-zed.md 🔗

@@ -383,13 +383,10 @@ left and right padding of the central pane from the workspace when the centered
   `direnv` integration make it possible to use the environment variables set by a `direnv` configuration to detect some language servers in `$PATH` instead of installing them.
   It also allows for those environment variables to be used in tasks.
 - Setting: `load_direnv`
-- Default:
-
-```json
-"load_direnv": "direct"
-```
+- Default: `"direct"`
 
 **Options**
+
 There are two options to choose from:
 
 1. `shell_hook`: Use the shell hook to load direnv. This relies on direnv to activate upon entering the directory. Supports POSIX shells and fish.
@@ -409,6 +406,7 @@ There are two options to choose from:
       "**/*.key",
       "**/*.cert",
       "**/*.crt",
+      "**/.dev.vars",
       "**/secrets.yml"
     ]
   }
@@ -420,7 +418,7 @@ There are two options to choose from:
 
 - Description: A list of globs for which edit predictions should be disabled for. This list adds to a pre-existing, sensible default set of globs. Any additional ones you add are combined with them.
 - Setting: `disabled_globs`
-- Default: `["**/.env*", "**/*.pem", "**/*.key", "**/*.cert", "**/*.crt", "**/secrets.yml"]`
+- Default: `["**/.env*", "**/*.pem", "**/*.key", "**/*.cert", "**/*.crt", "**/.dev.vars", "**/secrets.yml"]`
 
 **Options**
 
@@ -814,7 +812,8 @@ List of `string` values
   "file_icons": false,
   "git_status": false,
   "activate_on_close": "history",
-  "show_close_button": "hover"
+  "show_close_button": "hover",
+  "show_diagnostics": "off"
 },
 ```
 
@@ -918,6 +917,38 @@ List of `string` values
 }
 ```
 
+### Show Diagnostics
+
+- Description: Whether to show diagnostics indicators in tabs. This setting only works when file icons are active and controls which files with diagnostic issues to mark.
+- Setting: `show_diagnostics`
+- Default: `off`
+
+**Options**
+
+1. Do not mark any files:
+
+```json
+{
+  "show_diagnostics": "off"
+}
+```
+
+2. Only mark files with errors:
+
+```json
+{
+  "show_diagnostics": "errors"
+}
+```
+
+3. Mark files with errors and warnings:
+
+```json
+{
+  "show_diagnostics": "all"
+}
+```
+
 ## Editor Toolbar
 
 - Description: Whether or not to show various elements in the editor toolbar.
@@ -927,7 +958,8 @@ List of `string` values
 ```json
 "toolbar": {
   "breadcrumbs": true,
-  "quick_actions": true
+  "quick_actions": true,
+  "selections_menu": true
 },
 ```
 
@@ -1244,7 +1276,14 @@ Note, specifying `file_scan_exclusions` in settings.json will override the defau
 
 - Setting: `file_types`
 - Description: Configure how Zed selects a language for a file based on its filename or extension. Supports glob entries.
-- Default: `{}`
+- Default:
+
+```json
+"file_types": {
+  "JSONC": ["**/.zed/**/*.json", "**/zed/**/*.json", "**/Zed/**/*.json", "**/.vscode/**/*.json"],
+  "Shell Script": [".env.*"]
+}
+```
 
 **Examples**
 
@@ -1990,12 +2029,6 @@ Or to set a `socks5` proxy:
 
 - Description: When enabled, automatically adjusts search case sensitivity based on your query. If your search query contains any uppercase letters, the search becomes case-sensitive; if it contains only lowercase letters, the search becomes case-insensitive. \
   This applies to both in-file searches and project-wide searches.
-
-  Examples:
-
-  - Searching for "function" would match "function", "Function", "FUNCTION", etc.
-  - Searching for "Function" would only match "Function", not "function" or "FUNCTION"
-
 - Setting: `use_smartcase_search`
 - Default: `false`
 
@@ -2003,6 +2036,11 @@ Or to set a `socks5` proxy:
 
 `boolean` values
 
+Examples:
+
+- Searching for "function" would match "function", "Function", "FUNCTION", etc.
+- Searching for "Function" would only match "Function", not "function" or "FUNCTION"
+
 ## Show Call Status Icon
 
 - Description: Whether or not to show the call status icon in the status bar.
@@ -2134,10 +2172,12 @@ List of `integer` column numbers
 ```json
 {
   "terminal": {
-    "alternate_scroll": "on",
+    "alternate_scroll": "off",
     "blinking": "terminal_controlled",
     "copy_on_select": false,
     "dock": "bottom",
+    "default_width": 640,
+    "default_height": 320,
     "detect_venv": {
       "on": {
         "directories": [".env", "env", ".venv", "venv"],
@@ -2150,8 +2190,8 @@ List of `integer` column numbers
     "font_size": null,
     "line_height": "comfortable",
     "option_as_meta": false,
-    "button": false,
-    "shell": {},
+    "button": true,
+    "shell": "system",
     "toolbar": {
       "breadcrumbs": true
     },
@@ -2177,26 +2217,26 @@ List of `integer` column numbers
 
 - Description: Set whether Alternate Scroll mode (DECSET code: `?1007`) is active by default. Alternate Scroll mode converts mouse scroll events into up / down key presses when in the alternate screen (e.g. when running applications like vim or less). The terminal can still set and unset this mode with ANSI escape codes.
 - Setting: `alternate_scroll`
-- Default: `on`
+- Default: `off`
 
 **Options**
 
-1. Default alternate scroll mode to on
+1. Default alternate scroll mode to off
 
 ```json
 {
   "terminal": {
-    "alternate_scroll": "on"
+    "alternate_scroll": "off"
   }
 }
 ```
 
-2. Default alternate scroll mode to off
+2. Default alternate scroll mode to on
 
 ```json
 {
   "terminal": {
-    "alternate_scroll": "off"
+    "alternate_scroll": "on"
   }
 }
 ```
@@ -2453,7 +2493,7 @@ See Buffer Font Features
         // Default directories to search for virtual environments, relative
         // to the current working directory. We recommend overriding this
         // in your project's settings, rather than globally.
-        "directories": [".venv", "venv"],
+        "directories": [".env", "env", ".venv", "venv"],
         // Can also be `csh`, `fish`, and `nushell`
         "activate_script": "default"
       }
@@ -2668,6 +2708,7 @@ Run the `theme selector: toggle` action in the command palette to see a current
     "scrollbar": {
       "show": null
     },
+    "show_diagnostics": "all",
     "indent_guides": {
       "show": "always"
     }
@@ -2751,11 +2792,11 @@ Run the `theme selector: toggle` action in the command palette to see a current
 
 - Description: Customize default width taken by project panel
 - Setting: `default_width`
-- Default: N/A width in pixels (eg: 420)
+- Default: `240`
 
 **Options**
 
-`boolean` values
+`float` values
 
 ### Auto Reveal Entries
 
@@ -2813,8 +2854,9 @@ Run the `theme selector: toggle` action in the command palette to see a current
 
 ### Indent Guides: Show
 
-- Description: Whether to show indent guides in the project panel. Possible values: "always", "never".
+- Description: Whether to show indent guides in the project panel.
 - Setting: `indent_guides`
+- Default:
 
 ```json
 "indent_guides": {
@@ -2886,14 +2928,21 @@ Run the `theme selector: toggle` action in the command palette to see a current
 
 ```json
 "assistant": {
+  "version": "2",
   "enabled": true,
   "button": true,
   "dock": "right",
   "default_width": 640,
   "default_height": 320,
-  "provider": "openai",
-  "version": "1",
-},
+  "default_model": {
+    "provider": "zed.dev",
+    "model": "claude-3-5-sonnet-latest"
+  },
+  "editor_model": {
+    "provider": "zed.dev",
+    "model": "claude-3-5-sonnet-latest"
+  }
+}
 ```
 
 ## Outline Panel
@@ -2905,7 +2954,7 @@ Run the `theme selector: toggle` action in the command palette to see a current
 ```json
 "outline_panel": {
   "button": true,
-  "default_width": 240,
+  "default_width": 300,
   "dock": "left",
   "file_icons": true,
   "folder_icons": true,
@@ -2972,7 +3021,14 @@ The name of any font family installed on the system.
 
 - Description: The OpenType features to enable for text in the UI.
 - Setting: `ui_font_features`
-- Default: `null`
+- Default:
+
+```json
+"ui_font_features": {
+  "calt": false
+}
+```
+
 - Platform: macOS and Windows.
 
 **Options**