docs(@angular/cli): document serving the app from disk

Closes angular#4290

Author: Brocco

docs/documentation/serve.md

@@ -24,4 +24,7 @@ All the build Options are available in serve below are the additional options.
 
 `--ssl-cert` SSL certificate to use for serving HTTPS.
 
-`--ssl-key` SSL key to use for serving HTTPS.
+`--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.

docs/documentation/stories.md

@@ -20,3 +20,4 @@
  - [Routing](stories/routing)
  - [3rd Party Lib](stories/third-party-lib)
  - [Corporate Proxy](stories/using-corporate-proxy)
+ - [Serve from Disk](stories/disk-serve)

docs/documentation/stories/disk-serve.md

@@ -0,0 +1,23 @@
+# Serving from Disk
+
+The CLI supports running a live reload experience to users by running `ng serve`. This will compile the application upon file saves and reload the browser with the newly compiled application. This is done by hosting the application in memory and serving it via [webpack-dev-server](https://webpack.js.org/guides/development/#webpack-dev-server).
+
+If you wish to get a similar experience with the application output to disk please use the steps below.
+
+## Environment Setup
+### Install a web server
+Because you will not be using webpack-dev-server you will need to install a web server for the browser to request the application. There are many to choose from but a good one to try is [live-server](https://www.npmjs.com/package/live-server) as it will auto-reload your browser when new files are outputed.
+
+## Usage
+In order to mimic the live-reload you get with `ng serve` by default you will need to open two terminals. The first will run the build in a watch mode to compile the application to the `dist` folder. The second will run the web server against the dist folder. The combination of these two processes will mimic the same behavior of `ng serve`.
+### 1st terminal - Start the build
+```bash
+ng build --watch
+```
+### 2nd terminal - Start the web server
+```bash
+live-server dist
+```
+
+### Open browser
+Navigate to the URL the web server uses. (The default URL for live-server is `http://127.0.0.1:8080`)