chore: tweak changelog and setup text

Author: wardbell

public/docs/ts/latest/guide/change-log.jade

@@ -5,16 +5,24 @@ block includes
   The Angular documentation is a living document with continuous improvements.
   This log calls attention to recent significant changes.
 
-  ## NEW: Added `src/` folder to all examples (2017-02-02)
-  We've updated all our examples include a `src/` folder at the project root. 
-  Having this folder helps separate app code from setup and configuration files.
-  You can read about moving your existing project to this structure in 
-  [the QuickStart repo update instructions](https://github.com/angular/quickstart#updating-to-a-newer-version-of-the-quickstart-repo).
-  * `app/main.ts` has been moved to `src/main.ts`.
-  * `app/` has been moved to `src/app/`.
-  * `index.html`, `styles.css` and `tsconfig.json` have been moved inside `src/`.
+  ## NEW: Samples re-structured with `src/` folder (2017-02-02)
+  All documentation samples have been realigned with the default folder structure of the angular-cli.
+  That's a step along the road to basing our sample in the angular-cli.
+  But it's also good in its own right. 
+  It helps clearly separate app code from setup and configuration files.
+
+  We've updated all samples with an `src/` folder at the project root.
+  The former `app/` folder moves under `src/`. 
+  Read about moving your existing project to this structure in 
+  <a href="https://github.com/angular/quickstart#updating-to-a-newer-version-of-the-quickstart-repo" target="_blank" target="Migrating samples/quickstart app to the src folder">
+  the QuickStart repo update instructions</a>.
+
+  Notably:
+  * `app/main.ts` moved to `src/main.ts`.
+  * `app/` moved to `src/app/`.
+  * `index.html`, `styles.css` and `tsconfig.json` moved inside `src/`.
   * `systemjs.config.js` now imports `main.js` instead of `app`.
-  * `lite-server` configuration (`bs-config.json`) to serve `src/`.
+  * Added `lite-server` configuration (`bs-config.json`) to serve `src/`.
 
   ## NEW: Reactive Forms guide (2017-01-31)
   The new [**Reactive Forms**](reactive-forms.html) guide explains how and why to build a "reactive form".

public/docs/ts/latest/guide/setup.jade

@@ -129,12 +129,15 @@ block core-files
     `)(format='.')
 
 :marked
-  All guides and cookbooks have _at least these core files_. Each file has a distinct purpose and evolves independently as the application grows.
+  All guides and cookbooks have _at least these core files_. 
+  Each file has a distinct purpose and evolves independently as the application grows.
 
-  Outside `src/` are files meant to support your app, like configuration files and external dependencies.
+  Files inside `src/` "belong" to your app.
+  Add new Typescript, HTML and CSS files inside the `src/` directory, most of them inside `src/app`,
+  unless told to do otherwise.
 
-  Whenever a new Typescript, HTML or CSS file is created, it should go inside the `src/` directory (unless noted otherwise).
-  This is the folder containing your app itself.
+  Files outside `src/` concern building, deploying, and testing your app.
+  They include configuration files and external dependencies.
 
 style td, th {vertical-align: top}
 table(width="100%")