fixup! docs: add generation schematics option docs

Author: jbogarthyde

packages/schematics/angular/directive/schema.json

@@ -6,7 +6,7 @@
   "properties": {
     "name": {
       "type": "string",
-      "description": "The name of the directive.",
+      "description": "The name of the new directive.",
       "$default": {
         "$source": "argv",
         "index": 0
@@ -16,7 +16,7 @@
     "path": {
       "type": "string",
       "format": "path",
-      "description": "The path to create the interface.",
+      "description": "The path at which to create the interface that defines the directive, relative to the current workspace.",
       "visible": false
     },
     "project": {
@@ -28,7 +28,7 @@
     },
     "prefix": {
       "type": "string",
-      "description": "The prefix to apply to generated selectors.",
+      "description": "A prefix to apply to generated selectors.",
       "alias": "p",
       "oneOf": [
         {
@@ -42,38 +42,38 @@
     },
     "spec": {
       "type": "boolean",
-      "description": "Specifies if a spec file is generated.",
+      "description": "When true (the default), generates a  \"spec.ts\" test file for the new directive.",
       "default": true
     },
     "skipImport": {
       "type": "boolean",
-      "description": "Flag to skip the module import.",
+      "description": "When true, does not import this directive into the owning NgModule.",
       "default": false
     },
     "selector": {
       "type": "string",
       "format": "html-selector",
-      "description": "The selector to use for the directive."
+      "description": "The HTML selector to use for this directive."
     },
     "flat": {
       "type": "boolean",
-      "description": "Flag to indicate if a directory is created.",
+      "description": "When true (the default), creates the new files at the top level of the current project.",
       "default": true
     },
     "module":  {
       "type": "string",
-      "description": "Allows specification of the declaring module.",
+      "description": "The declaring NgModule.",
       "alias": "m"
     },
     "export": {
       "type": "boolean",
       "default": false,
-      "description": "Specifies if declaring module exports the directive."
+      "description": "When true, the declaring NgModule exports this directive."
     },
     "lintFix": {
       "type": "boolean",
       "default": false,
-      "description": "Specifies whether to apply lint fixes after generating the directive."
+      "description": "When true, applies lint fixes after generating the directive."
     }
   },
   "required": [

packages/schematics/angular/e2e/e2e-long.md

@@ -0,0 +1 @@
+The e2e tests are created in a separate app, next to the project being tested in the `projects` folder of the workspace.

packages/schematics/angular/e2e/schema.json

@@ -3,14 +3,16 @@
   "id": "SchematicsAngularE2eApp",
   "title": "Angular e2e Application Options Schema",
   "type": "object",
+  "description": "Generates a new, generic end-to-end test definition for the given or default project.",
+  "long-description": "e2e-long.md",
   "properties": {
     "projectRoot": {
-      "description": "The root directory of the new application.",
+      "description": "The root folder for the new test app.",
       "type": "string",
       "visible": false
     },
     "name": {
-      "description": "The name of the e2e application.",
+      "description": "The name of the new e2e app.",
       "type": "string",
       "format": "html-selector",
       "$default": {
@@ -19,7 +21,7 @@
       }
     },
     "rootSelector": {
-      "description": "HTML selector for the root component.",
+      "description": "The HTML selector for the root component of the test app.",
       "type": "string",
       "default": "app-root"
     },

packages/schematics/angular/enum/schema.json

@@ -3,6 +3,7 @@
   "id": "SchematicsAngularEnum",
   "title": "Angular Enum Options Schema",
   "type": "object",
+  "description": "Generates a new, generic enum definition for the given or default project.",
   "properties": {
     "name": {
       "type": "string",
@@ -16,20 +17,20 @@
     "path": {
       "type": "string",
       "format": "path",
-      "description": "The path to create the enum.",
+      "description": "The path at which to create the enum definition, relative to the current workspace.",
       "visible": false
     },
     "project": {
       "type": "string",
-      "description": "The name of the project.",
+      "description": "The name of the project in which to create the enum. Default is the configured default project for the workspace.",
       "$default": {
         "$source": "projectName"
       }
     },
     "lintFix": {
       "type": "boolean",
       "default": false,
-      "description": "Specifies whether to apply lint fixes after generating the enum."
+      "description": "When true, applies lint fixes after generating the enum."
     }
   },
   "required": [

packages/schematics/angular/guard/schema.json

@@ -3,10 +3,11 @@
   "id": "SchematicsAngularGuard",
   "title": "Angular Guard Options Schema",
   "type": "object",
+  "description": "Generates a new, generic route guard definition in the given or default project.",
   "properties": {
     "name": {
       "type": "string",
-      "description": "The name of the guard.",
+      "description": "The name of the new route guard.",
       "$default": {
         "$source": "argv",
         "index": 0
@@ -15,18 +16,22 @@
     },
     "spec": {
       "type": "boolean",
-      "description": "Specifies if a spec file is generated.",
+      "description": "When true (the default), generates a  \"spec.ts\" test file for the new guard.",
       "default": true
     },
     "flat": {
       "type": "boolean",
+<<<<<<< HEAD
       "description": "Flag to indicate if a directory is created.",
+=======
+      "description": "When true (the default), creates the new files at the top level of the current project.",
+>>>>>>> fixup! docs: add generation schematics option docs
       "default": true
     },
     "path": {
       "type": "string",
       "format": "path",
-      "description": "The path to create the interface.",
+      "description": "The path at which to create the interface that defines the guard, relative to the current workspace.",
       "visible": false
     },
     "project": {
@@ -39,7 +44,7 @@
     "lintFix": {
       "type": "boolean",
       "default": false,
-      "description": "Specifies whether to apply lint fixes after generating the guard."
+      "description": "When true, applies lint fixes after generating the guard."
     }
   },
   "required": [