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.