diff --git a/public/docs/ts/latest/guide/npm-packages.jade b/public/docs/ts/latest/guide/npm-packages.jade index 4981177dba..533384e0f4 100644 --- a/public/docs/ts/latest/guide/npm-packages.jade +++ b/public/docs/ts/latest/guide/npm-packages.jade @@ -8,7 +8,7 @@ include ../_util-fns Node.js and npm are essential to Angular 2 development. - Get it now if it's not already installed on your machine + Get it now if it's not already installed on your machine. **Verify that you are running at least node `v4.x.x` and npm `3.x.x`** by running `node -v` and `npm -v` in a terminal/console window. @@ -79,10 +79,10 @@ a(id="dependencies") This package also includes the bootstrapStatic method for bootstrapping applications for production builds that pre-compile templates offline. ***@angular/platform-browser-dynamic*** - Providers and a bootstrap method for applications that - compile templates on the client. don’t use offline compilation. - We use this package for boostrapping during development and for boostrapping plunker samples + compile templates on the client. Don’t use offline compilation. + We use this package for boostrapping during development and for boostrapping plunker samples. - ***@angular/http*** - Angular's http client + ***@angular/http*** - Angular's http client. ***@angular/router*** - Component router. @@ -111,20 +111,20 @@ a(id="polyfills") :marked See "[Why peerDependencies?](#why-peer-dependencies)" below for background on this requirement. :marked - ***core-js*** - monkey patches the global context (window) with essential features of ES2015 (ES6). + ***core-js*** - Monkey patches the global context (window) with essential features of ES2015 (ES6). Developers may substitute an alternative polyfill that provides the same core APIs. This dependency should go away once these APIs are implemented by all supported ever-green browsers. - ***reflect-metadata*** - a dependency shared between Angular and the ***TypeScript compiler***. + ***reflect-metadata*** - A dependency shared between Angular and the ***TypeScript compiler***. Developers should be able to update a TypeScript package without upgrading Angular, which is why this is a dependency of the application and not a dependency of Angular. - ***rxjs*** - a polyfill for the [Observables specification](https://github.com/zenparsing/es-observable) currently before the + ***rxjs*** - A polyfill for the [Observables specification](https://github.com/zenparsing/es-observable) currently before the [TC39](http://www.ecma-international.org/memento/TC39.htm) committee that determines standards for the JavaScript language. Developers should be able to pick a preferred version of *rxjs* (within a compatible version range) without waiting for Angular updates. - ***zone.js*** - a polyfill for the [Zone specification](https://gist.github.com/mhevery/63fdcdf7c65886051d55) currently before the + ***zone.js*** - A polyfill for the [Zone specification](https://gist.github.com/mhevery/63fdcdf7c65886051d55) currently before the [TC39](http://www.ecma-international.org/memento/TC39.htm) committee that determines standards for the JavaScript language. Developers should be able to pick a preferred version of *zone.js* to use (within a compatible version range) without waiting for Angular updates. @@ -139,7 +139,7 @@ a(id="other") Good for demos, documentation samples, and early stage development (before we even have a server). Learn about it in the [Http Client](server-communication.html#appendix-tour-of-heroes-in-memory-server) chapter. - ***bootstrap*** - [bootstrap](http://getbootstrap.com/) is a popular HTML and CSS framework for designing responsive web apps. + ***bootstrap*** - [Bootstrap](http://getbootstrap.com/) is a popular HTML and CSS framework for designing responsive web apps. Some of the documentation samples improve their appearance with *bootstrap*. a(id="dev-dependencies") @@ -150,16 +150,16 @@ a(id="dev-dependencies") They do not have to be deployed with the production application although there is rarely harm in doing so. ***[concurrently](https://www.npmjs.com/package/concurrently)*** - - a utility to run multiple *npm* commands concurrently on OS/X, Windows, and Linux operating systems. + A utility to run multiple *npm* commands concurrently on OS/X, Windows, and Linux operating systems. ***[lite-server](https://www.npmjs.com/package/lite-server)*** - - a light-weight, static file server, written and maintained by [John Papa](http://johnpapa.net/) + A light-weight, static file server, written and maintained by [John Papa](http://johnpapa.net/) with excellent support for Angular apps that use routing. ***[typescript](https://www.npmjs.com/package/typescript)*** - - the TypeScript language server including the *tsc* TypeScript compiler. + The TypeScript language server including the *tsc* TypeScript compiler. - ***[typings](https://www.npmjs.com/package/typings)*** - a manager for TypeScript definition files. + ***[typings](https://www.npmjs.com/package/typings)*** - A manager for TypeScript definition files. Learn more about it in the [TypeScript Configuration](typescript-configuration.html#typings) chapter. This section likely grows as we add more tools, testing, and build support.