Merge pull request #189 from angular/master

 docs start rewriting docs

Author: GulajavaMinistudio

.monorepo.json

@@ -42,16 +42,16 @@
   },
   "packages": {
     "@_/benchmark": {
-      "version": "0.9.0-rc.1",
-      "hash": "a9b1f213a4069f789d20021bda616775"
+      "version": "0.9.0-rc.2",
+      "hash": "ed6f2ae751fd3db351a20ae55349e8ad"
     },
     "@_/builders": {
-      "version": "0.9.0-rc.1",
-      "hash": "f34470f978203f13c312094472b0a343"
+      "version": "0.9.0-rc.2",
+      "hash": "569aef8bc23693c344e71b9755e62c50"
     },
     "devkit": {
-      "version": "0.9.0-rc.1",
-      "hash": "3552542bc61cedbeab0fd5b9dd6ae44c"
+      "version": "0.9.0-rc.2",
+      "hash": "9230702b29c8827fca50617e90f4db62"
     },
     "@angular/cli": {
       "name": "Angular CLI",
@@ -62,15 +62,15 @@
           "url": "https://github.com/angular/angular-cli/blob/master/packages/angular/cli/README.md"
         }
       ],
-      "version": "7.0.0-rc.1",
+      "version": "7.0.0-rc.2",
       "snapshotRepo": "angular/cli-builds",
-      "hash": "71c538637e997e786449b8be2f5549f1"
+      "hash": "0f0265f67cbd611fe76f9cf2a35eac46"
     },
     "@angular/pwa": {
       "name": "Angular PWA Schematics",
       "section": "Schematics",
-      "version": "0.9.0-rc.1",
-      "hash": "57add138d13c50761208286b625d8111",
+      "version": "0.9.0-rc.2",
+      "hash": "a575d61acf532ea665ac6705e91a0369",
       "snapshotRepo": "angular/angular-pwa-builds"
     },
     "@angular-devkit/architect": {
@@ -81,21 +81,21 @@
           "url": "https://github.com/angular/angular-cli/blob/master/packages/angular_devkit/architect/README.md"
         }
       ],
-      "version": "0.9.0-rc.1",
-      "hash": "6bdbfa3a9aed04efa9509be2b553124c",
+      "version": "0.9.0-rc.2",
+      "hash": "c644f2be33bdc5068cf74fb4f7c39e29",
       "snapshotRepo": "angular/angular-devkit-architect-builds"
     },
     "@angular-devkit/architect-cli": {
       "name": "Architect CLI",
-      "version": "0.9.0-rc.1",
-      "hash": "c1eb256f9547fb5c836ec70dd2c408f8",
+      "version": "0.9.0-rc.2",
+      "hash": "f0ad25801262bdf4cd4a83f678af7dd6",
       "snapshotRepo": "angular/angular-devkit-architect-cli-builds"
     },
     "@angular-devkit/benchmark": {
       "name": "Benchmark",
       "section": "Tooling",
-      "version": "1.0.0-rc.1",
-      "hash": "c11b907aeab37274a842f73524ec5e73"
+      "version": "1.0.0-rc.2",
+      "hash": "4809184dd4ad5a0b8e3e28ff460a2837"
     },
     "@angular-devkit/build-optimizer": {
       "name": "Build Optimizer",
@@ -105,8 +105,8 @@
           "url": "https://github.com/angular/angular-cli/blob/master/packages/angular_devkit/build_optimizer/README.md"
         }
       ],
-      "version": "0.9.0-rc.1",
-      "hash": "e8feec7840897e25731c34238506deae",
+      "version": "0.9.0-rc.2",
+      "hash": "ab55ec940e1f2e84073b45a16d45e3cd",
       "snapshotRepo": "angular/angular-devkit-build-optimizer-builds"
     },
     "@angular-devkit/build-ng-packagr": {
@@ -117,8 +117,8 @@
           "url": "https://github.com/angular/angular-cli/blob/master/packages/angular_devkit/build_ng_packagr/README.md"
         }
       ],
-      "version": "0.9.0-rc.1",
-      "hash": "977f57fe835fac53197d7b288b760268",
+      "version": "0.9.0-rc.2",
+      "hash": "a7cb02fd554c0947889e974cb9046d96",
       "snapshotRepo": "angular/angular-devkit-build-ng-packagr-builds"
     },
     "@angular-devkit/build-angular": {
@@ -129,8 +129,8 @@
           "url": "https://github.com/angular/angular-cli/blob/master/packages/angular_devkit/build_angular/README.md"
         }
       ],
-      "version": "0.9.0-rc.1",
-      "hash": "d0909d1a833531ef8b6d986e66a07311",
+      "version": "0.9.0-rc.2",
+      "hash": "d7fd8733c5b28f1ef21528b0066f0d1a",
       "snapshotRepo": "angular/angular-devkit-build-angular-builds"
     },
     "@angular-devkit/build-webpack": {
@@ -141,9 +141,9 @@
           "url": "https://github.com/angular/angular-cli/blob/master/packages/angular_devkit/build_webpack/README.md"
         }
       ],
-      "version": "0.9.0-rc.1",
+      "version": "0.9.0-rc.2",
       "snapshotRepo": "angular/angular-devkit-build-webpack-builds",
-      "hash": "a5f928555a349b1e584964911ef55c9a"
+      "hash": "a2574369237d6b3769f7602ff8fa4a31"
     },
     "@angular-devkit/core": {
       "name": "Core",
@@ -153,8 +153,8 @@
           "url": "https://github.com/angular/angular-cli/blob/master/packages/angular_devkit/core/README.md"
         }
       ],
-      "version": "7.0.0-rc.1",
-      "hash": "a24d7471f344677ee8ca3c8040dfe525",
+      "version": "7.0.0-rc.2",
+      "hash": "a5844a4ed97391807c4fd12cb2ef1cf2",
       "snapshotRepo": "angular/angular-devkit-core-builds"
     },
     "@angular-devkit/schematics": {
@@ -165,43 +165,43 @@
           "url": "https://github.com/angular/angular-cli/blob/master/packages/angular_devkit/schematics/README.md"
         }
       ],
-      "version": "7.0.0-rc.1",
-      "hash": "0aa3a0aade670fd19956e25e2963af54",
+      "version": "7.0.0-rc.2",
+      "hash": "c17d545d96ae49c8a80275cfc986eb4c",
       "snapshotRepo": "angular/angular-devkit-schematics-builds"
     },
     "@angular-devkit/schematics-cli": {
       "name": "Schematics CLI",
       "section": "Tooling",
-      "version": "0.9.0-rc.1",
-      "hash": "c6b8c15ed7abad30375f61b1e2ef66c0",
+      "version": "0.9.0-rc.2",
+      "hash": "e1fdd7b7f2ea718c3a22d16915a91ff6",
       "snapshotRepo": "angular/angular-devkit-schematics-cli-builds"
     },
     "@ngtools/webpack": {
       "name": "Webpack Angular Plugin",
-      "version": "7.0.0-rc.1",
+      "version": "7.0.0-rc.2",
       "section": "Misc",
-      "hash": "86d64917c76fb65c37572e7ec2748ccb",
+      "hash": "780c036bfa14accd80cd0bd4c2c7704d",
       "snapshotRepo": "angular/ngtools-webpack-builds"
     },
     "@schematics/angular": {
       "name": "Angular Schematics",
       "section": "Schematics",
-      "version": "7.0.0-rc.1",
-      "hash": "db9156bfaccc70bac955fb15def05fe3",
+      "version": "7.0.0-rc.2",
+      "hash": "f204ff9639c871494ac8fe050e327df0",
       "snapshotRepo": "angular/schematics-angular-builds"
     },
     "@schematics/schematics": {
       "name": "Schematics Schematics",
-      "version": "0.9.0-rc.1",
+      "version": "0.9.0-rc.2",
       "section": "Schematics",
-      "hash": "1ad492543597cb539b795682c5c3e1bf",
+      "hash": "4a3e9d9fc64c6efddb0dfba3b745c92a",
       "snapshotRepo": "angular/schematics-schematics-builds"
     },
     "@schematics/update": {
       "name": "Package Update Schematics",
-      "version": "0.9.0-rc.1",
+      "version": "0.9.0-rc.2",
       "section": "Schematics",
-      "hash": "1126ff9f1093897d184a696b6c72764a",
+      "hash": "6706dfa9fbc9cdbc892fb6e9ed8026f8",
       "snapshotRepo": "angular/schematics-update-builds"
     }
   }

packages/angular/cli/commands/build-long.md

@@ -0,0 +1,5 @@
+Resources in CSS, such as images and fonts, are automatically written and fingerprinted at the root
+of the output folder.  If a resource is less than 10kb, it  is also included inline.
+
+Uses the Webpack build tool, with environment and build options specified in the CLI configuration
+file.

packages/angular/cli/commands/build.json

@@ -1,8 +1,8 @@
 {
   "$schema": "http://json-schema.org/schema",
   "$id": "ng-cli://commands/build.json",
-  "description": "Builds your app and places it into the output path (dist/ by default).",
-  "$longDescription": "",
+  "description": "Compiles an Angular app into an output directory named dist/ at the given output path. Must be executed from within a workspace directory.",
+  "$longDescription": "./build-long.md",
 
   "$aliases": [ "b" ],
   "$scope": "in",

packages/angular/cli/commands/definitions.json

@@ -7,21 +7,21 @@
       "properties": {
         "project": {
           "type": "string",
-          "description": "The name of the project to build.",
+          "description": "The name of the project to build. Can be an app or a library.",
           "$default": {
             "$source": "argv",
             "index": 0
           }
         },
         "configuration": {
-          "description": "Specify the configuration to use.",
+          "description": "A named configuration environment, as specified in the `configurations` section of `angular.json`.",
           "type": "string",
           "aliases": [
             "c"
           ]
         },
         "prod": {
-          "description": "Flag to set configuration to 'production'.",
+          "description": "When true, sets the build configuration to the production environment.\nAll builds make use of bundling and limited tree-shaking, A production build also runs limited dead code elimination using UglifyJS.",
           "type": "boolean"
         }
       }

packages/angular_devkit/build_angular/src/browser/schema.json

@@ -12,15 +12,16 @@
     },
     "main": {
       "type": "string",
-      "description": "The name of the main entry-point file."
+      "description": "The full path for the main entry point to the app, relative to the current workspace.",
+      "$valueDescription": "fileName"
     },
     "polyfills": {
       "type": "string",
-      "description": "The name of the polyfills file."
+      "description": "The full path for the polyfills file, relative to the current workspace."
     },
     "tsConfig": {
       "type": "string",
-      "description": "The name of the TypeScript configuration file."
+      "description": "The full path for the TypeScript configuration file, relative to the current workspace."
     },
     "scripts": {
       "description": "Global scripts to be included in the build.",
@@ -55,7 +56,7 @@
     },
     "optimization": {
       "type": "boolean",
-      "description": "Enables optimization of the build output.",
+      "description": "When true, uses optimization for the app build.",
       "default": false
     },
     "fileReplacements": {
@@ -68,7 +69,7 @@
     },
     "outputPath": {
       "type": "string",
-      "description": "Path where output will be placed."
+      "description": "The full path for the new output directory, relative to the current workspace.\n\nBy default, writes output to a folder named dist/ in the current project."
     },
     "aot": {
       "type": "boolean",
@@ -408,4 +409,4 @@
       ]
     }
   }
-}
+}

packages/angular_devkit/build_angular/test/browser/poll_spec_large.ts

@@ -15,7 +15,7 @@ describe('Browser Builder poll', () => {
   beforeEach(done => host.initialize().toPromise().then(done, done.fail));
   afterEach(done => host.restore().toPromise().then(done, done.fail));
 
-  it('works', (done) => {
+  xit('works', (done) => {
     const overrides = { watch: true, poll: 2000 };
     const intervals: number[] = [];
     let startTime: number | undefined;

packages/angular_devkit/core/src/virtual-fs/host/record.ts

@@ -26,6 +26,7 @@ import {
   HostCapabilities,
   HostWatchOptions,
   ReadonlyHost,
+  Stats,
 } from './interface';
 import { SimpleMemoryHost } from './memory';
 
@@ -366,6 +367,12 @@ export class CordHost extends SimpleMemoryHost {
       : ((this.willDelete(path) || this.willRename(path)) ? of(false) : this._back.isFile(path));
   }
 
+  stat(path: Path): Observable<Stats | null> | null {
+    return this._exists(path)
+      ? super.stat(path)
+      : ((this.willDelete(path) || this.willRename(path)) ? of(null) : this._back.stat(path));
+  }
+
   watch(path: Path, options?: HostWatchOptions) {
     // Watching not supported.
     return null;