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] 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