Update doc strings for command reference

packages/angular/cli/commands/config.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/schema",
   "$id": "ng-cli://commands/config.json",
-  "description": "Get/set configuration values.",
+  "description": "Retrieves or sets Angular configuration values.",
   "$longDescription": "",
 
   "$aliases": [],
@@ -15,23 +15,23 @@
       "properties": {
         "jsonPath": {
           "type": "string",
-          "description": "The path to the value to get/set.",
+          "description": "The configuration key to set or query, in JSON path format. For example: \"a[3].foo.bar[2]\". If no new value is provided, returns the current value of this key.",
           "$default": {
             "$source": "argv",
             "index": 0
           }
         },
         "value": {
           "type": ["string", "number", "boolean"],
-          "description": "The new value to be set.",
+          "description": "If provided, a new value for the given configuration key.",
           "$default": {
             "$source": "argv",
             "index": 1
           }
         },
         "global": {
           "type": "boolean",
-          "description": "Get/set the value in the global configuration (in your home directory).",
+          "description": "When true, accesses the global configuration in the caller's home directory.",
           "default": false,
           "aliases": ["g"]
         }

packages/angular/cli/commands/definitions.json

@@ -14,7 +14,7 @@
           }
         },
         "configuration": {
-          "description": "A named configuration environment, as specified in the `configurations` section of `angular.json`.",
+          "description": "A named configuration environment, as specified in the \"configurations\" section of angular.json.",
           "type": "string",
           "aliases": [
             "c"
@@ -31,7 +31,7 @@
       "properties": {
         "help": {
           "enum": [true, false, "json", "JSON"],
-          "description": "Shows a help message. You can pass the format as a value.",
+          "description": "Shows a help message for this command in the console.",
           "default": false
         }
       }
@@ -42,23 +42,23 @@
           "type": "boolean",
           "default": false,
           "aliases": [ "d" ],
-          "description": "Run through without making any changes."
+          "description": "When true, run through and report activity without writing out results."
         },
         "force": {
           "type": "boolean",
           "default": false,
           "aliases": [ "f" ],
-          "description": "Forces overwriting of files."
+          "description": "When true, force overwriting of existing files."
         },
         "interactive": {
           "type": "boolean",
           "default": "true",
-          "description": "Disables interactive inputs (i.e., prompts)."
+          "description": "When false, disables interactive input prompts."
         },
         "defaults": {
           "type": "boolean",
           "default": "false",
-          "description": "Disables interactive inputs (i.e., prompts) for options with a default."
+          "description": "When true, disables interactive input prompts for options with a default."
         }
       }
     }

packages/angular/cli/commands/doc.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/schema",
   "$id": "ng-cli://commands/doc.json",
-  "description": "Opens the official Angular API documentation for a given keyword.",
+  "description": "Opens the official Angular documentation (angular.io) in a browser, and searches for a given keyword.",
   "$longDescription": "",
 
   "$aliases": [ "d" ],
@@ -14,7 +14,7 @@
       "properties": {
         "keyword": {
           "type": "string",
-          "description": "The query to search upon.",
+          "description": "The keyword to search for, as provided in the search bar in angular.io.",
           "$default": {
             "$source": "argv",
             "index": 0
@@ -24,7 +24,7 @@
           "aliases": ["s"],
           "type": "boolean",
           "default": false,
-          "description": "Search whole angular.io instead of just api."
+          "description": "When true, searches all of angular.io. Otherwise, searches only API reference documentation."
         }
       },
       "required": [

packages/angular/cli/commands/e2e.json

@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/schema",
   "$id": "ng-cli://commands/e2e.json",
-  "description": "Runs the end-to-end tests.",
-  "$longDescription": "",
+  "description": "Builds and serves an Angular app, and runs end-to-end tests using Protractor.",
+  "$longDescription": "Must be executed from within a workspace directory.\n When a project name is not supplied, the configured default e2e project of the workspace is used.",
 
   "$aliases": [ "e" ],
   "$scope": "in",

packages/angular/cli/commands/help.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/schema",
   "$id": "ng-cli://commands/help.json",
-  "description": "Displays help for the Angular CLI.",
+  "description": "Lists available commands and their short descriptions in the console. \n &nbsp &nbsp For help with individual commands, use the \"--help\" or \"-h\" option with the command.",
   "$longDescription": "",
 
   "$scope": "all",

packages/angular/cli/commands/lint-long.md

@@ -0,0 +1,2 @@
+Takes the name of the project, as specified in the  `projects` section of the `angular.json` workspace configuration file.
+When a project name is not supplied, uses the configured `defaultProject` of the workspace.

packages/angular/cli/commands/lint.json

@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/schema",
   "$id": "ng-cli://commands/lint.json",
-  "description": "Lints code in existing project.",
-  "$longDescription": "",
+  "description": "Runs the TSLint tool on Angular app code in the given project folder.",
+  "$longDescription": "./lint-long.md",
 
   "$aliases": [ "l" ],
   "$scope": "in",