From d83ed4e03eeaea45aad7a8a513783dc53e9809f7 Mon Sep 17 00:00:00 2001
From: Marshall Bowers <git@maxdeviant.com>
Date: Thu, 23 Oct 2025 13:52:35 -0400
Subject: [PATCH] docs: Update docs for `theme_overrides` setting (#41038)

This PR updates the docs to reference the `theme_overrides` setting
instead of the old `experimental.theme_overrides` setting.

Release Notes:

- N/A
---
 docs/src/configuring-languages.md | 18 ++++++++++--------
 docs/src/themes.md                | 20 +++++++++++---------
 2 files changed, 21 insertions(+), 17 deletions(-)

diff --git a/docs/src/configuring-languages.md b/docs/src/configuring-languages.md
index 9a7157ceaecbcc956e1e98688dfee01316225a3a..e04d63f5d16a83c84b933d9f59db901c276b7a6d 100644
--- a/docs/src/configuring-languages.md
+++ b/docs/src/configuring-languages.md
@@ -364,18 +364,20 @@ Zed offers customization options for syntax highlighting and themes, allowing yo
 
 ### Customizing Syntax Highlighting
 
-Zed uses Tree-sitter grammars for syntax highlighting. Override the default highlighting using the `experimental.theme_overrides` setting.
+Zed uses Tree-sitter grammars for syntax highlighting. Override the default highlighting using the `theme_overrides` setting.
 
 This example makes comments italic and changes the color of strings:
 
 ```json [settings]
-"experimental.theme_overrides": {
-  "syntax": {
-    "comment": {
-      "font_style": "italic"
-    },
-    "string": {
-      "color": "#00AA00"
+"theme_overrides": {
+  "One Dark": {
+    "syntax": {
+      "comment": {
+        "font_style": "italic"
+      },
+      "string": {
+        "color": "#00AA00"
+      }
     }
   }
 }
diff --git a/docs/src/themes.md b/docs/src/themes.md
index 438301dc13fe04b8b75ba0df348cdf499c49c329..460d00a7627e55f21958142c230b683d92301040 100644
--- a/docs/src/themes.md
+++ b/docs/src/themes.md
@@ -32,20 +32,22 @@ By default, Zed maintains two themes: one for light mode and one for dark mode.
 
 ## Theme Overrides
 
-To override specific attributes of a theme, use the `experimental.theme_overrides` setting.
+To override specific attributes of a theme, use the `theme_overrides` setting. This setting can be used to configure theme-specific overrides.
 
 For example, add the following to your `settings.json` if you wish to override the background color of the editor and display comments and doc comments as italics:
 
 ```json [settings]
 {
-  "experimental.theme_overrides": {
-    "editor.background": "#333",
-    "syntax": {
-      "comment": {
-        "font_style": "italic"
-      },
-      "comment.doc": {
-        "font_style": "italic"
+  "theme_overrides": {
+    "One Dark": {
+      "editor.background": "#333",
+      "syntax": {
+        "comment": {
+          "font_style": "italic"
+        },
+        "comment.doc": {
+          "font_style": "italic"
+        }
       }
     }
   }