diff --git a/docs/documentation/stories/application-environments.md b/docs/documentation/stories/application-environments.md
index d3c4b18d054c..337a999f0501 100644
--- a/docs/documentation/stories/application-environments.md
+++ b/docs/documentation/stories/application-environments.md
@@ -2,7 +2,7 @@
 
 ## Configuring available environments
 
-`.angular-cli.json` contains an **environments** section.  By default, this looks like:
+`angular.json` contains an **environments** section for each application.  By default, this looks like:
 
 ``` json
 "environments": {
@@ -105,18 +105,22 @@ export class AppComponent {
 
 ## Environment-specific builds
 
-Running:
+Running builds for specific environements:
 
-```
-ng build
-```
-
-Will use the defaults found in `environment.ts`
-
-Running:
+- Inside `angular.json` create a configuration for the environment (i.e. staging)
 
+```json
+...{
+"configurations": {
+  "staging": {
+    "fileReplacements": [{
+      "replace": "src/environments/environment.ts",
+      "with": "src/environments/environment.staging.ts",
+    }],
+  }
+}
 ```
-ng build --env=staging
+2. Build your application by specifying the new configuration.
+```bash
+ng build --configuration staging
 ```
-
-Will use the values from `environment.staging.ts`