docs: expand doc for initial cmds

Author: jbogarthyde

packages/angular/cli/commands/add.json

@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/schema",
   "$id": "ng-cli://commands/add.json",
-  "description": "Add support for a library to your project.",
+  "description": "Adds support for a published library to your project.",
   "$longDescription": "./add.md",
 
   "$scope": "in",

packages/angular/cli/commands/add.md

@@ -1,2 +1,3 @@
-Add support for a library in your project, for example adding `@angular/pwa` which would configure
-your project for PWA support.
+Adds the npm package for a published library to your workspace, and configures your default
+app project to use that library, in whatever way is specified by the library's schematic.
+For example, adding `@angular/pwa` configures your project for PWA support.

packages/angular/cli/commands/new.json

@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/schema",
   "$id": "ng-cli://commands/new.json",
-  "description": "Creates a new directory and a new Angular app.",
-  "$longDescription": "",
+  "description": "Creates a new workspace and a new default Angular app.",
+  "$longDescription": "./new.md",
 
   "$aliases": [ "n" ],
   "$scope": "out",

packages/angular/cli/commands/new.md

@@ -0,0 +1,5 @@
+Creates and initializes a new Angular app that is the default project for a new workspace.
+
+* The new workspace folder is given the specified project name. The new app is created at the top level of the workspace folder.
+
+* The new app's configuration appears in the `projects` section of the `angular.json` workspace configuration file, under its project name.

packages/angular/cli/commands/update.json

@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/schema",
   "$id": "ng-cli://commands/update.json",
-  "description": "Updates your application and its dependencies.",
-  "$longDescription": "",
+  "description": "Updates your application and its dependencies. See \"https://update.angular.io/\",
+  "$longDescription": "./update.md",
 
   "$scope": "all",
   "$aliases": [],

packages/angular/cli/commands/update.md

@@ -0,0 +1 @@
+Before running this command, see the interactive [Angular Update Guide](https://update.angular.io/).