Skip to content

Commit 307621f

Browse files
committed
Add experimentation section
1 parent 3a8c53c commit 307621f

File tree

1 file changed

+11
-4
lines changed

1 file changed

+11
-4
lines changed

docs/configure/telemetry.md

Lines changed: 11 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,9 @@ MetaDescription: Learn about Visual Studio Code collected telemetry and how to o
55
---
66
# Telemetry
77

8-
Visual Studio Code collects telemetry data, which is used to help understand how to improve the product. For example, this usage data helps to debug issues, such as slow start-up times, and to prioritize new features. While we appreciate the insights this data provides, we also know that not everyone wants to send usage data and you can disable telemetry as described in [disable telemetry reporting](#disable-telemetry-reporting). You can also read our [privacy statement](https://go.microsoft.com/fwlink/?LinkID=528096&clcid=0x409) to learn more.
8+
Visual Studio Code collects telemetry data, which is used to help understand how to improve the product. For example, this usage data helps to debug issues, such as slow start-up times, and to prioritize new features. We also use this data to [roll out new features](#feature-availability-and-telemetry) to a subset of users before making them generally available.
9+
10+
While we appreciate the insights this data provides, we also know that not everyone wants to send usage data and you can disable telemetry as described in [disable telemetry reporting](#disable-telemetry-reporting). You can also read our [privacy statement](https://go.microsoft.com/fwlink/?LinkID=528096&clcid=0x409) to learn more.
911

1012
## Types of telemetry data
1113

@@ -19,7 +21,7 @@ VS Code and this page refer to three different types of data with respect to tel
1921

2022
## Disable telemetry reporting
2123

22-
With the `setting(telemetry.telemetryLevel)` user [setting](/docs/configure/settings.md), you can control the different types of telemetry we send with a single setting. Here is a table of the different types of data sent with each value of `setting(telemetry.telemetryLevel)`:
24+
With the `setting(telemetry.telemetryLevel)` user setting, you can control the different types of telemetry we send with a single setting. Here is a table of the different types of data sent with each value of `setting(telemetry.telemetryLevel)`:
2325

2426
| | Crash Reports | Error Telemetry | Usage Data |
2527
|:------|:---------------------:|:---------------:|:--------------:|
@@ -28,7 +30,7 @@ With the `setting(telemetry.telemetryLevel)` user [setting](/docs/configure/sett
2830
| crash || - | - |
2931
| off | - | - | - |
3032

31-
For example, if you don't want to send any telemetry data to Microsoft, you can set the `setting(telemetry.telemetryLevel)` user [setting](/docs/configure/settings.md) to `off`. This will silence all telemetry events from VS Code going forward. Note that telemetry information may have been collected and sent up until the point when you disable the setting.
33+
For example, if you don't want to send any telemetry data to Microsoft, you can set the `setting(telemetry.telemetryLevel)` user setting to `off`. This will silence all telemetry events from VS Code going forward. Note that telemetry information may have been collected and sent up until the point when you disable the setting.
3234

3335
![disable telemetry](images/telemetry/disable-telemetry.png)
3436

@@ -38,6 +40,12 @@ If you use the JSON editor for your settings, add the following line:
3840
"telemetry.telemetryLevel": "off"
3941
```
4042

43+
## Feature availability and telemetry
44+
45+
VS Code uses an A/B experimentation system to roll out new features to a subset of users before making them generally available. This helps us validate that a new feature is working as expected across a diverse set of users before rolling it out to everyone. By participating in experimentation, you help us improve the quality of VS Code and can help shape the future of the product through early feedback.
46+
47+
To enable this experimentation system, VS Code uses the usage data telemetry data to determine which users should receive the new feature. If you disable usage data telemetry by setting `setting(telemetry.telemetryLevel)` to `error`, `crash`, or `off`, experimentation is not available to you and the roll out of new features to you might be delayed.
48+
4149
## Extensions and telemetry
4250

4351
VS Code lets you add features to the product by installing Microsoft and third-party extensions. These extensions may be collecting their own usage data and are not controlled by the `setting(telemetry.telemetryLevel)` setting. Consult the specific extension's documentation to learn about its telemetry reporting and whether it can be disabled.
@@ -156,4 +164,3 @@ Please read the [extension guides telemetry document](/api/extension-guides/tele
156164
* [Centrally manage telemetry log level](/docs/setup/enterprise.md#configure-telemetry-level) - Learn how to set the telemetry log level for your organization.
157165
* [Visual Studio Code FAQ](/docs/supporting/faq.md) - Consult the Frequently Asked Questions to learn more.
158166
* [User and Workspace Settings](/docs/configure/settings.md) - Read about available options to customize VS Code.
159-
* [Key Bindings](/docs/configure/keybindings.md) - You can easily modify commonly used keyboard shortcuts.

0 commit comments

Comments
 (0)