From 552d43417019a8d0a85e74a2cb4757945f3998f2 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 1 Jun 2026 15:48:25 +0000
Subject: [PATCH 1/2] Initial plan
From 58a8052fda3e74c57b2fee8fc2319877ad43e97b Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Mon, 1 Jun 2026 16:22:02 +0000
Subject: [PATCH 2/2] Fix Linux enterprise policy examples to valid JSON
---
docs/enterprise/policies.md | 76 +++++++---------------------
docs/enterprise/policies.template.md | 76 +++++++---------------------
2 files changed, 38 insertions(+), 114 deletions(-)
diff --git a/docs/enterprise/policies.md b/docs/enterprise/policies.md
index be727fee52b..11da43eeebd 100644
--- a/docs/enterprise/policies.md
+++ b/docs/enterprise/policies.md
@@ -156,40 +156,21 @@ Starting from VS Code version 1.99, each release ships with a sample `.mobilecon
1. Open the copied file in a text editor (for example, TextEdit, VS Code, or any XML editor).
1. Edit the policy values according to your requirements:
- **String policies** - policies that accept text values or JSON strings:
-
- ```xml
-
- AllowedExtensions
- {"microsoft": true, "github": true}
-
-
- UpdateMode
- start
+ Example `policy.json` configuration:
+
+ ```json
+ {
+ "AllowedExtensions": {"microsoft": true, "github": true},
+ "UpdateMode": "start",
+ "EnableFeedback": true,
+ "EnableTelemetry": false
+ }
```
> [!IMPORTANT]
> If there's a syntax error in the policy value, the setting will not be applied. You can check the Window log in VS Code for errors (press `kb(workbench.action.showCommands)` and enter **Show Window Log**).
- **Boolean policies** - policies that accept true/false values:
-
- ```xml
-
- EnableFeedback
-
-
-
- EnableTelemetry
-
- ```
-
- **Remove unwanted policies** - delete both the key and value for any policy you don't want to enforce:
-
- ```xml
-
- UpdateMode
- start
- ```
+ **Remove unwanted policies** - remove the corresponding JSON property for any policy you don't want to enforce.
Refer to the [policy reference](#vs-code-enterprise-policy-reference) for details on each policy's accepted values and behavior.
@@ -276,40 +257,21 @@ Starting from VS Code version 1.106, each release ships with a sample `.policy.j
1. Edit the policy values according to your requirements:
- **String policies** - policies that accept text values or JSON strings:
+ Example `policy.json` configuration:
- ```xml
-
- AllowedExtensions
- {"microsoft": true, "github": true}
-
-
- UpdateMode
- start
+ ```json
+ {
+ "AllowedExtensions": {"microsoft": true, "github": true},
+ "UpdateMode": "start",
+ "EnableFeedback": true,
+ "EnableTelemetry": false
+ }
```
> [!IMPORTANT]
> If there's a syntax error in the policy value, the setting will not be applied. You can check the Window log in VS Code for errors (press `kb(workbench.action.showCommands)` and enter **Show Window Log**).
- **Boolean policies** - policies that accept true/false values:
-
- ```xml
-
- EnableFeedback
-
-
-
- EnableTelemetry
-
- ```
-
- **Remove unwanted policies** - delete both the key and value for any policy you don't want to enforce:
-
- ```xml
-
- UpdateMode
- start
- ```
+ **Remove unwanted policies** - remove the corresponding JSON property for any policy you don't want to enforce.
Refer to the [policy reference](#vs-code-enterprise-policy-reference) for details on each policy's accepted values and behavior.
diff --git a/docs/enterprise/policies.template.md b/docs/enterprise/policies.template.md
index 19366d038dc..0d3ac5a4cea 100644
--- a/docs/enterprise/policies.template.md
+++ b/docs/enterprise/policies.template.md
@@ -156,40 +156,21 @@ Starting from VS Code version 1.99, each release ships with a sample `.mobilecon
1. Open the copied file in a text editor (for example, TextEdit, VS Code, or any XML editor).
1. Edit the policy values according to your requirements:
- **String policies** - policies that accept text values or JSON strings:
-
- ```xml
-
- AllowedExtensions
- {"microsoft": true, "github": true}
-
-
- UpdateMode
- start
+ Example `policy.json` configuration:
+
+ ```json
+ {
+ "AllowedExtensions": {"microsoft": true, "github": true},
+ "UpdateMode": "start",
+ "EnableFeedback": true,
+ "EnableTelemetry": false
+ }
```
> [!IMPORTANT]
> If there's a syntax error in the policy value, the setting will not be applied. You can check the Window log in VS Code for errors (press `kb(workbench.action.showCommands)` and enter **Show Window Log**).
- **Boolean policies** - policies that accept true/false values:
-
- ```xml
-
- EnableFeedback
-
-
-
- EnableTelemetry
-
- ```
-
- **Remove unwanted policies** - delete both the key and value for any policy you don't want to enforce:
-
- ```xml
-
- UpdateMode
- start
- ```
+ **Remove unwanted policies** - remove the corresponding JSON property for any policy you don't want to enforce.
Refer to the [policy reference](#vs-code-enterprise-policy-reference) for details on each policy's accepted values and behavior.
@@ -276,40 +257,21 @@ Starting from VS Code version 1.106, each release ships with a sample `.policy.j
1. Edit the policy values according to your requirements:
- **String policies** - policies that accept text values or JSON strings:
+ Example `policy.json` configuration:
- ```xml
-
- AllowedExtensions
- {"microsoft": true, "github": true}
-
-
- UpdateMode
- start
+ ```json
+ {
+ "AllowedExtensions": {"microsoft": true, "github": true},
+ "UpdateMode": "start",
+ "EnableFeedback": true,
+ "EnableTelemetry": false
+ }
```
> [!IMPORTANT]
> If there's a syntax error in the policy value, the setting will not be applied. You can check the Window log in VS Code for errors (press `kb(workbench.action.showCommands)` and enter **Show Window Log**).
- **Boolean policies** - policies that accept true/false values:
-
- ```xml
-
- EnableFeedback
-
-
-
- EnableTelemetry
-
- ```
-
- **Remove unwanted policies** - delete both the key and value for any policy you don't want to enforce:
-
- ```xml
-
- UpdateMode
- start
- ```
+ **Remove unwanted policies** - remove the corresponding JSON property for any policy you don't want to enforce.
Refer to the [policy reference](#vs-code-enterprise-policy-reference) for details on each policy's accepted values and behavior.