diff --git a/packages/angular/cli/commands/analytics-long.md b/packages/angular/cli/commands/analytics-long.md
new file mode 100644
index 0000000000..60e0d86686
--- /dev/null
+++ b/packages/angular/cli/commands/analytics-long.md
@@ -0,0 +1,7 @@
+The value of *settingOrProject* is one of the following.
+* "on" : Enables analytics gathering and reporting for the user.
+* "off" : Disables analytics gathering and reporting for the user.
+* "ci" : Enables analytics and configures reporting for use with Continuous Integration,
+which uses a common CI user.
+* "prompt" : Prompts the user to set the status interactively.
+* "project" : Sets the default status for the project to the *projectSetting* value, which can be any of the other values. The *projectSetting* argument is ignored for all other values of *settingOrProject*.
\ No newline at end of file
diff --git a/packages/angular/cli/commands/analytics.json b/packages/angular/cli/commands/analytics.json
index f2e1705916..f806e5c8e7 100644
--- a/packages/angular/cli/commands/analytics.json
+++ b/packages/angular/cli/commands/analytics.json
@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/schema",
   "$id": "ng-cli://commands/analytics.json",
   "description": "Configures the gathering of Angular CLI usage metrics. See https://v8.angular.io/cli/usage-analytics-gathering.",
-  "$longDescription": "",
+  "$longDescription": "./analytics-long.md",
 
   "$aliases": [],
   "$scope": "all",