=BG= miscellaneous copy editing

Author: bguiz

about/intro.md

@@ -2,72 +2,54 @@
 
 Angularity is a philosophy of development.
 
-Our focus is maintaining uniformity of development across groups of corporate developers who hold varying experience levels.
+Our focus is maintaining uniformity of development across groups of developers who hold varying experience levels.
 
-Our contributors hold a collective vision of best-practice Angular-js development and have condensed this into a set of tools and resources known as **Angularity**.
+Our contributors hold a collective vision of best-practice AngularJS development and have condensed this into a set of tools and resources known as **Angularity**.
 
 ## Features
 
-Primarily Angularity is a javascript build tool build on [`node-js`](http://nodejs.org/). Its features include:
+Primarily Angularity is a [`node.js`](http://nodejs.org/) build tool. Its features include:
 
 * Single `npm global install` for all projects.
-
-* [`Ecmascript-6`](http://en.wikipedia.org/wiki/ECMAScript#ECMAScript_Harmony_.286th_Edition.29) syntax (using [`es6ify`](http://thlorenz.github.io/es6ify/)). Code import and ES-6 specific features.
-
+* [`ECMAScript 6`](http://en.wikipedia.org/wiki/ECMAScript#ECMAScript_Harmony_.286th_Edition.29) syntax (using [`es6ify`](http://thlorenz.github.io/es6ify/)), including code import and other ES6 specific features.
 * [`jsHint`](http://www.jshint.com/about/) linting.
-
 * [`SASS`](http://sass-lang.com/) 3.2 (using [`libsass`](http://libsass.org/)).
-
 * [`Bourbon`](http://bourbon.io/) mixin library for SASS.
-
 * [`Bower`](http://bower.io/) for web dependencies.
-
 * Bower or node packages for shared code.
-
 * Javascript unit testing (using [`Karma`](http://karma-runner.github.io/0.12/index.html) and [`Jasmine 2.0`](http://jasmine.github.io/2.0/introduction.html)).
-
-* Sourcemaps for javascript (from Ecmascript-6 through minification).
-
-* Sourcemaps for CSS.
-
+* Source maps for Javascript (from ECMAScript 6 through minification).
+* Source maps for CSS.
 * Release versioning *[experimental]*.
 
-At its heart, none of these features are specifically tied to [`Angular-js`](https://angularjs.org/). However much of the material you will find on this site is geared to Angular development.
+At its heart, none of these features are specifically tied to [`AngularJS`](https://angularjs.org/). However much of the material you will find on this site is geared to Angular development.
 
 ## Suitability
 
-### You should use *angularity* when...
+### You should use *Angularity* when...
 
 * You have several development teams and need uniformity of development.
-
-* You develop with [`Angular-js`](https://angularjs.org/) and are open to working with [`Ecmascript-6`](http://en.wikipedia.org/wiki/ECMAScript#ECMAScript_Harmony_.286th_Edition.29), especially ES-6 Classes.
-
+* You develop with [`AngularJS`](https://angularjs.org/) and are open to working with [`ECMAScript 6`](http://en.wikipedia.org/wiki/ECMAScript#ECMAScript_Harmony_.286th_Edition.29), especially ES6 Classes.
 * You use [`SASS`](http://sass-lang.com/), or are prepared to switch, and there are sufficient SASS mixins for you in the [`Bourbon`](http://bourbon.io/) library.
-
-* You intend to `minify` or obfuscate your javascript.
-
+* You intend to minify or obfuscate your Javascript.
 * You deploy to a [`Content Delivery Network (CDN)`](http://en.wikipedia.org/wiki/Content_delivery_network) and need to version your releases.
-
-* You your browser support list permits [`Ecmascript 5.1`](http://kangax.github.io/compat-table/es5/).
-
+* You your browser support list permits [`ECMAScript 5.1`](http://kangax.github.io/compat-table/es5/).
 * You would like your build tool to be an `npm global install`.
 
-### You should avoid *angularity* when...
-
-* You don't want to work with [`Ecmascript-6`](http://en.wikipedia.org/wiki/ECMAScript#ECMAScript_Harmony_.286th_Edition.29), are avoiding [`Traceur`](https://github.com/google/traceur-compiler) and its runtime, and can live without Object Orientated code.
+### You should avoid *Angularity* when...
 
+* You don't want to work with [`ECMAScript 6`](http://en.wikipedia.org/wiki/ECMAScript#ECMAScript_Harmony_.286th_Edition.29), are avoiding [`Traceur`](https://github.com/google/traceur-compiler) and its runtime, and can live without Object Orientated code.
 * You want to use a CSS preprocessor other than [`SASS`](http://sass-lang.com/).
-
 * You would like to use [`Compass`](http://compass-style.org/) with your SASS.
-
 * You need to support [`PhantomJS`](http://phantomjs.org/) 1.x, `Internet Exporer 8` or lower.
 
-### You should fork *angularity* when...
+### You should fork *Angularity* when...
 
 * You want different build steps to those provided.
-
 * You want features that are not on our roadmap.
 
-Angularity is about uniformity. Per-project customisation is very small. If you develop a wide variety of applications you may ultimately find a conventional build (with something like [`Gulp`](http://gulpjs.com/)) will work better for you.
+Angularity is about uniformity.
+Per-project customisation should be minimal.
+If you develop a wide variety of applications you may ultimately find a conventional build (with something like [`Gulp`](http://gulpjs.com/)) will work better for you.
 
-[Roadmap ⟶](roadmap.md)
+[Roadmap ⟶](roadmap.md)

about/roadmap.md

@@ -7,45 +7,32 @@ Regarding `documentation`.
 The following items are listed in priority order but will necessarily be completed before version 1.0.0 release of the build tool.
 
 * Getting started guide.
-
 * Troubleshooting guide.
-
 * Quick reference for development style, including comparison of ES5 and ES6 use cases.
-
 * Manual for the build tool, including how it works.
 
 ## Build tool
 
-Regarding `node-angularity`, the angularity build tool.
+Regarding `node-angularity`, the Angularity build tool.
 
 ### Version 1.0.0
 
-* Ecmascript-5 development using `common-js` syntax *[Under consideration]*.
- 
+* ECMAScript 5 development using `common-js` syntax *[Under consideration]*.
 * Per-project configuration of `Karma` browser list and other selected unit testing settings.
-
 * Refinement of release versioning, including per-project `CDN` settings.
-
 * Generation of an `index.aspx` page in the release bundle and potentially other hooks to easily deploy on .NET systems.
 
 ### Version 1.x.0
 
 * Build blocking on `js-hint` *[Under consideration]*.
-
 * Generation of API documentation using [`JSdoc`](https://github.com/jsdoc3/jsdoc).
-
 * Incremental compilation.
-
-* Basic or experiemental support for [`Protractor`](https://docs.angularjs.org/guide/e2e-testing) end-to-end testing with local server or [`SauceLabs`](https://saucelabs.com/).
-
+* Basic or experimental support for [`Protractor`](https://docs.angularjs.org/guide/e2e-testing) end-to-end testing with local server or [`SauceLabs`](https://saucelabs.com/).
 * Continuous Integration (`CI`) testing for the system itself *[Under consideration]*.
 
 ### Version 2.x.0
 
 * `Karma` testing with [`PhantomJS 2.0`](http://ariya.ofilabs.com/2014/07/towards-phantomjs-2.html).
-
 * Enhanced code-style enforcement using [`eslint (v0.10.0)`](https://github.com/eslint/eslint/wiki/Release-goals#v0100).
-
 * Full support for [`Protractor`](https://docs.angularjs.org/guide/e2e-testing) with private [`Grid2`](https://code.google.com/p/selenium/wiki/Grid2) solution.
-
-* Test console (HTML page) with real-time red/green indication for your unit tests *[under consideration]*.
+* Test console (HTML page) with real-time red/green indication for your unit tests *[under consideration]*.

getting-started/installation.md

@@ -13,11 +13,11 @@ On **Windows** platform choose to **checkout Windows-style, commit Unit-style**
 [![](installation-git-1.png)]()
 [![](installation-git-2.png)]()
 
-## Install node
+## Install node.js
 
 [`http://nodejs.org/download/`](http://nodejs.org/download/)
 
-Ensure that you choose the correct binary for your system. Meaning that 64bit systems should choose the 64bit binary.
+Ensure that you choose the correct binary for your system. Meaning that 64 bit systems should choose the 64 bit binary.
 
 [![](installation-node.png)]()
 
@@ -40,18 +40,18 @@ projects.
 
 ## Install Bower
 
-Bower is a popular Frontend package manager that makes it easier to consume libraries for web development.
+Bower is a popular front end package manager that makes it easier to consume libraries for web development.
 
 `npm install bower -g`
 
 See more info on the [Bower website](http://bower.io).
 
-## Install angularity
+## Install Angularity
 
 Angularity is a **global** install.
 
 `npm install angularity -g`
 
-You are now ready to start an angularity project.
+You are now ready to start an Angularity project.
 
-[Project Setup ⟶](project-setup.md)
+[Project Setup ⟶](project-setup.md)

getting-started/project-setup.md

@@ -1,3 +1,3 @@
 # Project setup
 
-Documentation will be forthcomming soon.
+Documentation is coming soon.

guide/composition.md

@@ -5,7 +5,6 @@ It is important not to hide composition. It should be done centrally, at the roo
 In angular there are 2 different resources we must compose in order to build an application
 
 * Using a **composition root** we map `directives`, `controllers`, and `services` into the `injector`.
-
 * Using **routing** we compose views from HTML `partials` and `controllers` for each different **application state**.
 
 ## Composition Root
@@ -17,16 +16,20 @@ It is important for composition that each component (`directives`, `controllers`
 These components fit together all in one place - the **composition root**. The composition root may be organised into multiple files so long as this aids clarity.
 
 We therefore need define only one `module` in the entire application. However that module must be dependent on the  `templates` module. Meaning:
+
 ```
-  angular.module('app', [ 'templates' ])
+  angular.module('app', [ 'templates' ]);
 ```
-This `templates` module is automatically generated from the HTML `partials`. The build system converts the HTML to a javascript routine that populates the angular **template cache**. This makes the `partials` immediately available to angular in a transparent manner.
+
+This `templates` module is automatically generated from the HTML `partials`.
+The build system converts the HTML to a Javascript routine that populates the angular **template cache**.
+This makes the `partials` immediately available to angular in a transparent manner.
 
 ## Routing
 
 > In a single page application it is critical that we encode **application state** in the **route**. This enables bookmarking and **deep linking** to reconstruct the page given only the URL.
 
-For every change in view we need to encode `state` in the route. Where we have hierachical `state`, as with the angular [UI-router](https://github.com/angular-ui/ui-router/wiki), each layer of the state has its own HTML `partial` and recursively contains other views.
+For every change in view we need to encode `state` in the route. Where we have hierarchical `state`, as with the angular [UI-router](https://github.com/angular-ui/ui-router/wiki), each layer of the state has its own HTML `partial` and recursively contains other views.
 
 > If you find your lowest-level partial is large it is likely you do **not** have sufficiently detailed `state`.
 
@@ -68,4 +71,4 @@ export default function todoRoutes($stateProvider, $urlRouterProvider) {
       controller:  MyController
     });
 }
-```
+```

index.md

@@ -1,9 +1,9 @@
-# ![](assets/logo.png) *Angularity*
+# ![Angularity Logo](assets/logo.png) *Angularity*
 
 > Angularity is a philosophy of development.
 
-> Our focus is maintaining uniformity of development across groups of corporate developers who hold varying experience levels.
+> Our focus is maintaining uniformity of development across groups of developers who hold varying experience levels.
 
-> Our contributors hold a collective vision of best-practice Angular-js development and have condensed this into a set of tools and resources known as **Angularity**.
+> Our contributors hold a collective vision of best-practice AngularJS development and have condensed this into a set of tools and resources known as **Angularity**.
 
-[About ⟶](about/intro.md)
+[About ⟶](about/intro.md)