message: docs: rewrite cli analytics config
  PR Close
diff: -# Gathering Usage Analytics
  -Administrators can configure their instances of Angular CLI to share usage analytics with
  -third parties. This sharing is separate from and in addition to usage analytics shared
  -with Google. It is disabled by default and cannot be enabled at the project level for
  -all users. It must be set at the global configuration level for each user to allow
  -managed users to opt in and share usage analytics.
  +# Gathering and Viewing Usage Analytics
  -To configure usage analytics sharing, use the `ng config` command to add both the user ID
  -and the third-party ID to the user's global Angular CLI configuration.
  +Users can opt in to share their Angular CLI usage data with [Google Analytics](https://support.google.com/analytics/answer/1008015?hl=en), using the [`ng analytics` CLI command](analytics).
  +The data is also shared with the Angular team, and used to improve the CLI.
  -- The third-party ID is the tracking identifier of the third-party Google Analytics
  - account. This ID is a string that looks like `UA-123456-12`.
  -- You can choose a user ID, or be assigned a random user ID when you run the CLI command.
  +The gathering of CLI analytics data is disabled by default, and must be enabled at the project level by individual users.
  +It cannot be enabled at the project level for all users.
  -Once you have the third-party tracking ID, add it to your global configuration using the following command:
  +Data gathered in this way can be viewed on the Google Analytics site, but is not automatically visible on your own organization's Analytics site.
  +As an administrator for an Angular development group, you can configure your instance of Angular CLI to be able to see analytics data for your own team's usage of the Angular CLI.
  +This configuration option is separate from and in addition to other usage analytics that your users may be sharing with Google.
  -```
  +## Enable access to CLI usage data
  +
  +To configure access to your own users' CLI usage data, use the `ng config` command to add a key to your global [`angular.json` workspace configuration file](guide/workspace-config).
  +The key goes under `cli.analyticsSharing` at the top level of the file, outside the `projects` sections.
  +The value of the key is your organization's tracking ID, as assigned by Google Analytics.
  +This ID is a string that looks like `UA-123456-12`.
  +
  +You can choose to use a descriptive string as the key value, or be assigned a random key when you run the CLI command.
  +For example, the following command adds a configuration key named "tracking".
  +
  +<code-example language="sh" class="code-shell">
  ng config --global cli.analyticsSharing.tracking UA-123456-12
  -```
  +</code-example>
  +
  +To turn off this feature, run the following command:
  +
  +<code-example language="sh" class="code-shell">
  +ng config --global --remove cli.analyticsSharing
  +</code-example>
  -To add a custom user ID to the global configuration using the following command. This
  -should be unique per users to identify unique usage of commands and flags.
  -```
  +## Per user tracking
  +
  +You can add a custom user ID to the global configuration, in order to identify unique usage of commands and flags.
  +If that user enables CLI analytics for their own project, your analytics display tracks and labels their individual usage.
  +
  +
  +<code-example language="sh" class="code-shell">
  ng config --global cli.analyticsSharing.user SOME_USER_NAME
  -```
  +</code-example>
  To generate a new random user ID, run the following command:
  -```
  +<code-example language="sh" class="code-shell">
  ng config --global cli.analyticsSharing.user ""
  -```
  -
  -To turn off this feature, run the following command:
  -
  -```
  -ng config --global --remove cli.analyticsSharing
  -```
  +</code-example>
  