diff --git a/api/language-extensions/language-configuration-guide.md b/api/language-extensions/language-configuration-guide.md
index 5e472ab44b..21346b59e7 100644
--- a/api/language-extensions/language-configuration-guide.md
+++ b/api/language-extensions/language-configuration-guide.md
@@ -75,6 +75,23 @@ VS Code offers two commands for comment toggling. **Toggle Line Comment** and **
 }
 ```
 
+The `lineComment` property supports two formats for backwards compatibility:
+
+- A string value for simple line comment definitions.
+- An object value that enables configuring the indentation behavior of comment lines.
+
+```json
+{
+  "comments": {
+    "lineComment": {
+      "comment": "//",
+      "noIndent": true
+    },
+    "blockComment": ["/*", "*/"]
+  }
+}
+```
+
 ## Brackets definition
 
 When you move the cursor to a bracket defined here, VS Code will highlight that bracket together with its matching pair.