docs: add generation schematics option docs

Author: jbogarthyde

packages/schematics/angular/app-shell/app-shell-long.md

@@ -3,14 +3,16 @@
   "id": "SchematicsAngularAppShell",
   "title": "Angular AppShell Options Schema",
   "type": "object",
+  "description": "Generates an app shell for running a server-side version of an app.",
+  "long-description": "",
   "properties": {
     "clientProject": {
       "type": "string",
-      "description": "Name of related client app."
+      "description": "The name of the related client app."
     },
     "universalProject": {
       "type": "string",
-      "description": "Name of related universal app."
+      "description": "The name of related Universal app."
     },
     "route": {
       "type": "string",
@@ -20,12 +22,12 @@
     "name": {
       "type": "string",
       "format": "html-selector",
-      "description": "Name of the universal app"
+      "description": "The HTML selector of the Universal app"
     },
     "appId": {
       "type": "string",
       "format": "html-selector",
-      "description": "The appId to use withServerTransition.",
+      "description": "The app ID to use in withServerTransition().",
       "default": "serverApp"
     },
     "outDir": {
@@ -43,7 +45,7 @@
     "index": {
       "type": "string",
       "format": "path",
-      "description": "Name of the index file",
+      "description": "The name of the index file",
       "default": "index.html"
     },
     "main": {

packages/schematics/angular/app-shell/schema.json

@@ -3,14 +3,15 @@
   "id": "SchematicsAngularApp",
   "title": "Angular Application Options Schema",
   "type": "object",
+  "description": "Generates a new app skeleton in the \"projects\" subfolder of the workspace.",
   "properties": {
     "projectRoot": {
-      "description": "The root directory of the new application.",
+      "description": "The root folder of the new app.",
       "type": "string",
       "visible": false
     },
     "name": {
-      "description": "The name of the application.",
+      "description": "The name of the new app.",
       "type": "string",
       "$default": {
         "$source": "argv",
@@ -19,57 +20,57 @@
       "x-prompt": "What name would you like to use for the application?"
     },
     "experimentalIvy": {
-      "description": "EXPERIMENTAL: Specifies whether to create a new application which uses the Ivy rendering engine.",
+      "description": "EXPERIMENTAL: True to create a new app that uses the Ivy rendering engine.",
       "type": "boolean",
       "default": false
     },
     "inlineStyle": {
-      "description": "Specifies if the style will be in the ts file.",
+      "description": "When true, includes styles in the TypeScript source file.",
       "type": "boolean",
       "default": false,
       "alias": "s"
     },
     "inlineTemplate": {
-      "description": "Specifies if the template will be in the ts file.",
+      "description": "When true, includes the template in the TypeScript source file.",
       "type": "boolean",
       "default": false,
       "alias": "t"
     },
     "viewEncapsulation": {
-      "description": "Specifies the view encapsulation strategy.",
+      "description": "The view encapsulation strategy to use in the new app.",
       "enum": ["Emulated", "Native", "None", "ShadowDom"],
       "type": "string"
     },
     "routing": {
       "type": "boolean",
-      "description": "Generates a routing module.",
+      "description": "When true, generates a routing module.",
       "default": false
     },
     "prefix": {
       "type": "string",
       "format": "html-selector",
-      "description": "The prefix to apply to generated selectors.",
+      "description": "A prefix to apply to generated selectors.",
       "default": "app",
       "alias": "p"
     },
     "style": {
-      "description": "The file extension to be used for style files.",
+      "description": "The file extension to use for style files.",
       "type": "string",
       "default": "css"
     },
     "skipTests": {
-      "description": "Skip creating spec files.",
+      "description": "When true, does not create spec test files for the app.",
       "type": "boolean",
       "default": false,
       "alias": "S"
     },
     "skipPackageJson": {
       "type": "boolean",
       "default": false,
-      "description": "Do not add dependencies to package.json."
+      "description": "When true, does not add dependencies to package.json."
     },
     "minimal": {
-      "description": "Create a barebones project without any testing frameworks",
+      "description": "When true, creates a bare-bones project without any testing frameworks.",
       "type": "boolean",
       "default": false
     }

packages/schematics/angular/application/schema.json

@@ -3,10 +3,11 @@
   "id": "SchematicsAngularClass",
   "title": "Angular Class Options Schema",
   "type": "object",
+  "description": "Creates a new class in the given or default project.",
   "properties": {
     "name": {
       "type": "string",
-      "description": "The name of the class.",
+      "description": "The name of the new class.",
       "$default": {
         "$source": "argv",
         "index": 0
@@ -16,7 +17,7 @@
     "path": {
       "type": "string",
       "format": "path",
-      "description": "The path to create the class.",
+      "description": "The path at which to create the class.",
       "visible": false
     },
     "project": {
@@ -28,12 +29,12 @@
     },
     "spec": {
       "type": "boolean",
-      "description": "Specifies if a spec file is generated.",
+      "description": "When true, generates a \"spec\" test file for the new class.",
       "default": false
     },
     "type": {
       "type": "string",
-      "description": "Specifies the type of class.",
+      "description": "The type of class.",
       "default": ""
     }
   },