diff --git a/packages/angular/cli/commands/run-long.md b/packages/angular/cli/commands/run-long.md
index 22404bf5a2..b68fa94fa5 100644
--- a/packages/angular/cli/commands/run-long.md
+++ b/packages/angular/cli/commands/run-long.md
@@ -1,7 +1,16 @@
 Architect is the tool that the CLI uses to perform complex tasks such as compilation, according to provided configurations.
-The CLI commands run Architect targets such as `build`, `serve`, `test` and `lint`. 
-Each named target has a default configuration, specified by an "options" object, and an optional set of named alternate configurations in the "configurations" object. 
-For example, the "build" target for a newly generated app has a predefined alternate configuration named "production". 
+The CLI commands run Architect targets such as `build`, `serve`, `test` and `lint`.
+Each named target has a default configuration, specified by an "options" object,
+and an optional set of named alternate configurations in the "configurations" object.
 
-You can define new targets and their configuration options in the "architect" section of the `angular.json` file.
-If you do so, you can run them from the command line using the `ng run` command.
\ No newline at end of file
+For example, the "server" target for a newly generated app has a predefined
+alternate configuration named "production".
+
+You can define new targets and their configuration options in the "architect" section
+of the `angular.json` file.
+If you do so, you can run them from the command line using the `ng run` command.
+Execute the command using the following format.
+
+```
+ng run project:target[.configuration]
+```
\ No newline at end of file
diff --git a/packages/angular/cli/commands/run.json b/packages/angular/cli/commands/run.json
index 673cca89f7..86f132f8f1 100644
--- a/packages/angular/cli/commands/run.json
+++ b/packages/angular/cli/commands/run.json
@@ -1,7 +1,7 @@
 {
   "$schema": "http://json-schema.org/schema",
   "$id": "ng-cli://commands/run.json",
-  "description": "Runs an architect target with a custom builder configuration defined in your project.",
+  "description": "Runs an architect target with an optional custom builder configuration defined in your project.",
   "$longDescription": "./run-long.md",
 
   "$aliases": [],
@@ -15,7 +15,7 @@
       "properties": {
         "target": {
           "type": "string",
-          "description": "The target to run.",
+          "description": "The Architect target to run.",
           "$default": {
             "$source": "argv",
             "index": 0