From 9a62cb923f43bdc519168e466a93c866ac8bad79 Mon Sep 17 00:00:00 2001
From: Dakota Bazan <148282997+DakotaB75@users.noreply.github.com>
Date: Thu, 1 Jan 2026 21:38:31 -0300
Subject: [PATCH 1/2] docs: document supported lineComment formats in language
 configuration

---
 .../language-configuration-guide.md            | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/api/language-extensions/language-configuration-guide.md b/api/language-extensions/language-configuration-guide.md
index 5e472ab44b..67af864fed 100644
--- a/api/language-extensions/language-configuration-guide.md
+++ b/api/language-extensions/language-configuration-guide.md
@@ -74,6 +74,24 @@ VS Code offers two commands for comment toggling. **Toggle Line Comment** and **
   }
 }
 ```
+The `lineComment` property supports two formats for backward compatibility:
+
+- A string value for simple line comment definitions.
+- An object value that allows additional configuration options.
+
+```json
+{
+  "comments": {
+    "lineComment": {
+      "comment": "//",
+      "noIndent": true
+    },
+    "blockComment": ["/*", "*/"]
+  }
+}
+```
+The object form allows additional control over line comments.  
+For example, `noIndent` disables automatic indentation when toggling line comments.
 
 ## Brackets definition
 

From a3c71d1ff39e0c246fe71a4455cc5a3cd7cac3c6 Mon Sep 17 00:00:00 2001
From: Nick Trogh <ntrogh@hotmail.com>
Date: Tue, 5 May 2026 22:07:26 +0200
Subject: [PATCH 2/2] Apply review edits

---
 api/language-extensions/language-configuration-guide.md | 7 +++----
 1 file changed, 3 insertions(+), 4 deletions(-)

diff --git a/api/language-extensions/language-configuration-guide.md b/api/language-extensions/language-configuration-guide.md
index 67af864fed..21346b59e7 100644
--- a/api/language-extensions/language-configuration-guide.md
+++ b/api/language-extensions/language-configuration-guide.md
@@ -74,10 +74,11 @@ VS Code offers two commands for comment toggling. **Toggle Line Comment** and **
   }
 }
 ```
-The `lineComment` property supports two formats for backward compatibility:
+
+The `lineComment` property supports two formats for backwards compatibility:
 
 - A string value for simple line comment definitions.
-- An object value that allows additional configuration options.
+- An object value that enables configuring the indentation behavior of comment lines.
 
 ```json
 {
@@ -90,8 +91,6 @@ The `lineComment` property supports two formats for backward compatibility:
   }
 }
 ```
-The object form allows additional control over line comments.  
-For example, `noIndent` disables automatic indentation when toggling line comments.
 
 ## Brackets definition