docs(@angular/cli): fix a few documentation inconsistencies

Author: delasteve

docs/documentation/_Sidebar.md

@@ -1,3 +1,3 @@
 * [Angular CLI](home)
 * [Generate](generate)
-* [Stories](stories)
+* [Stories](stories)

docs/documentation/build.md

@@ -75,8 +75,6 @@ or `ng serve --prod` will also make use of uglifying and tree-shaking functional
 
 `--dev` Build target and environment to development.
 
-`--output-path` (`-op`) path where output will be placed
-
 `--environment` (`-e`) Defines the build environment.
 
 `--extract-css` (`-ec`) Extract css from global styles onto css files instead of js ones.

docs/documentation/config.md

@@ -15,4 +15,4 @@
 `ng set [key]=[value]` Set a value in the configuration.
 
 ## Options
-`--global` Set the value in the global configuration rather than in your project's.
+`--global` Set the value in the global configuration rather than in your project's.

docs/documentation/e2e.md

@@ -22,4 +22,4 @@ End-to-end tests are run via [Protractor](https://angular.github.io/protractor/)
 
 `--specs` Override specs in the protractor config. Can send in multiple specs by repeating flag (ng e2e --specs=spec1.ts --specs=spec2.ts).
 
-`--webdriver-update` (`-wu`) (Default: true) Try to update webdriver.
+`--webdriver-update` (`-wu`) (Default: true) Try to update webdriver.

docs/documentation/generate/component.md

@@ -10,10 +10,10 @@
 
 `--change-detection` (`-cd`) Specifies the change detection strategy.
 
-`--flat` Flag to indicate if a dir is created.
-
 `--export` Specifies if declaring module exports the component.
 
+`--flat` Flag to indicate if a dir is created.
+
 `--inline-style` (`-is`) Specifies if the style will be in the ts file.
 
 `--inline-template` (`-it`) Specifies if the template will be in the ts file.
@@ -26,4 +26,4 @@
 
 `--spec` Specifies if a spec file is generated.
 
-`--view-encapsulation` (`-ve`) Specifies the view encapsulation strategy.
+`--view-encapsulation` (`-ve`) Specifies the view encapsulation strategy.

docs/documentation/generate/guard.md

@@ -8,6 +8,6 @@
 
 `--flat` Indicate if a dir is created.
 
-`--module` (`-m`) Allows specification of the declaring module.
+`--module` (`-m`) Specifies where the guard should be provided.
 
-`--spec` Specifies if a spec file is generated.
+`--spec` Specifies if a spec file is generated.

docs/documentation/generate/pipe.md

@@ -16,4 +16,4 @@
 
 `--skip-import` Allows for skipping the module import.
 
-`--spec` Specifies if a spec file is generated.
+`--spec` Specifies if a spec file is generated.

docs/documentation/generate/service.md

@@ -10,6 +10,6 @@
 
 `--flat` Flag to indicate if a dir is created.
 
-`--module` (`-m`) Allows you to specify the module where the service should be provided
+`--module` (`-m`) Specifies where the service should be provided.
 
 `--spec` Specifies if a spec file is generated.

docs/documentation/lint.md

@@ -6,7 +6,6 @@
 `ng lint` will lint you app code using tslint.
 
 ## Options
-
 `--fix` Fixes linting errors (may overwrite linted files).
 
 `--force` Succeeds even if there was linting errors.

docs/documentation/new.md

@@ -36,4 +36,4 @@ Default applications are created in a directory of the same name, with an initia
 
 `--style` The style file default extension.
 
-`--verbose` Adds more details to output logging.
+`--verbose` Adds more details to output logging.

docs/documentation/serve.md

@@ -27,4 +27,4 @@ All the build Options are available in serve, below are the additional options.
 `--ssl-key` SSL key to use for serving HTTPS.
 
 ## Note
-When running `ng serve`, the compiled output is served from memory, not from disk. This means that the application being served is not located on disk in the `dist` folder.
+When running `ng serve`, the compiled output is served from memory, not from disk. This means that the application being served is not located on disk in the `dist` folder.

docs/documentation/test.md

@@ -40,4 +40,4 @@ You can run tests with coverage via `--code-coverage`. The coverage report will
 
 `--sourcemap` Output sourcemaps.
 
-`--watch` (`-w`) Run build when files change.
+`--watch` (`-w`) Run build when files change.

docs/documentation/xi18n.md

@@ -6,16 +6,16 @@
 `ng xi18n` Extracts i18n messages from the templates.
 
 ## Options
-`--i18n-format` (`-f`) Output format for the generated file: either `xmb` or `xlf`.
+`--app` (`-a`) Specifies app name to use.
 
-`--output-path` (`-op`) Path where output will be placed.
+`--i18n-format` (`-f`) Output format for the generated file: either `xmb` or `xlf`.
 
 `--locale` (`-l`) Specifies the source language of the application.
 
 `--outfile` (`-of`)  Name of the file to output.
 
-`--verbose` Adds more details to output logging.
+`--output-path` (`-op`) Path where output will be placed.
 
 `--progress` Log progress to the console while running.
 
-`--app` (`-a`) Specifies app name to use.
+`--verbose` Adds more details to output logging.

packages/@angular/cli/blueprints/guard/index.ts

@@ -31,7 +31,7 @@ export default Blueprint.extend({
       name: 'module',
       type: String,
       aliases: ['m'],
-      description: 'Allows specification of the declaring module.'
+      description: 'Specifies where the guard should be provided.'
     }
   ],
 

packages/@angular/cli/blueprints/service/index.ts

@@ -30,7 +30,7 @@ export default Blueprint.extend({
     {
       name: 'module',
       type: String, aliases: ['m'],
-      description: 'Allows specification of the declaring module.'
+      description: 'Specifies where the service should be provided.'
     },
     {
       name: 'app',