From d1f4222c83218ea5fc1cff55eb4fb6128b87a5e0 Mon Sep 17 00:00:00 2001
From: Igor Minar <igor@angularjs.org>
Date: Mon, 8 Aug 2016 17:18:50 -0700
Subject: [PATCH] docs(cheatsheet): add NgModules docs to the cheatsheet

---
 modules/@angular/core/src/application_ref.ts  |  2 +-
 .../@angular/docs/cheatsheet/bootstrapping.md | 12 +++--
 .../docs/cheatsheet/built-in-directives.md    |  2 +-
 .../docs/cheatsheet/class-decorators.md       |  2 +-
 .../cheatsheet/component-configuration.md     | 16 +------
 .../docs/cheatsheet/dependency-injection.md   |  2 +-
 .../directive-and-component-decorators.md     |  2 +-
 .../cheatsheet/directive-configuration.md     |  2 +-
 modules/@angular/docs/cheatsheet/forms.md     |  6 +--
 .../docs/cheatsheet/lifecycle hooks.md        |  2 +-
 modules/@angular/docs/cheatsheet/ngmodules.md | 45 +++++++++++++++++++
 modules/@angular/docs/cheatsheet/routing.md   |  2 +-
 .../docs/cheatsheet/template-syntax.md        |  2 +-
 13 files changed, 63 insertions(+), 34 deletions(-)
 create mode 100644 modules/@angular/docs/cheatsheet/ngmodules.md

diff --git a/modules/@angular/core/src/application_ref.ts b/modules/@angular/core/src/application_ref.ts
index fc7072de54..eb2352c231 100644
--- a/modules/@angular/core/src/application_ref.ts
+++ b/modules/@angular/core/src/application_ref.ts
@@ -95,7 +95,7 @@ export function createPlatform(injector: Injector): PlatformRef {
 export type PlatformFactory = (extraProviders?: any[]) => PlatformRef;
 
 /**
- * Creates a fatory for a platform
+ * Creates a factory for a platform
  *
  * @experimental APIs related to application bootstrap are currently under review.
  */
diff --git a/modules/@angular/docs/cheatsheet/bootstrapping.md b/modules/@angular/docs/cheatsheet/bootstrapping.md
index 11371f4fb2..4d8a7aeab9 100644
--- a/modules/@angular/docs/cheatsheet/bootstrapping.md
+++ b/modules/@angular/docs/cheatsheet/bootstrapping.md
@@ -2,17 +2,15 @@
 Bootstrapping
 @cheatsheetIndex 0
 @description
-{@target ts}`import { bootstrap } from '@angular/platform-browser-dynamic';`{@endtarget}
-{@target js}Available from the `ng.platform.browser` namespace{@endtarget}
+{@target ts}`import { platformBrowserDynamic } from '@angular/platform-browser-dynamic';`{@endtarget}
+{@target js}Available from the `ng.platformBrowser` namespace{@endtarget}
 {@target dart}`import 'package:angular2/platform/browser.dart';`{@endtarget}
 
 @cheatsheetItem
 syntax(ts dart):
-`bootstrap​(MyAppComponent, [MyService, { provide: ... }]);`|`provide`
+`platformBrowserDynamic().bootstrapModule(MyAppModule);`|`platformBrowserDynamic().bootstrapModule`
 syntax(js):
 `document.addEventListener('DOMContentLoaded', function () {
-  ng.platform.browser.bootstrap(MyAppComponent,
-    [MyService, { provide: ... }]);
-});`|`provide`
+  ng.platformBrowser.platformBrowserDynamic().bootstrapModuleDynamic(MyAppModule);`|`platformBrowserDynamic().bootstrapModule`
 description:
-Bootstraps an application with MyAppComponent as the root component and configures the DI providers. {@target js}Must be wrapped in the event listener to fire when the page loads.{@endtarget}
+Bootstraps an application defined as MyAppModule ng module using the Just in Time compiler.{@target js}Must be wrapped in the event listener to fire when the page loads.{@endtarget}
diff --git a/modules/@angular/docs/cheatsheet/built-in-directives.md b/modules/@angular/docs/cheatsheet/built-in-directives.md
index ebb7102682..45dfc38492 100644
--- a/modules/@angular/docs/cheatsheet/built-in-directives.md
+++ b/modules/@angular/docs/cheatsheet/built-in-directives.md
@@ -1,6 +1,6 @@
 @cheatsheetSection
 Built-in directives
-@cheatsheetIndex 2
+@cheatsheetIndex 3
 @description
 {@target ts}`import {NgIf, ...} from '@angular/common';`{@endtarget}
 {@target js}Available from the `ng.common` namespace{@endtarget}
diff --git a/modules/@angular/docs/cheatsheet/class-decorators.md b/modules/@angular/docs/cheatsheet/class-decorators.md
index 8c9adec377..c8f172687b 100644
--- a/modules/@angular/docs/cheatsheet/class-decorators.md
+++ b/modules/@angular/docs/cheatsheet/class-decorators.md
@@ -1,6 +1,6 @@
 @cheatsheetSection
 Class decorators
-@cheatsheetIndex 4
+@cheatsheetIndex 5
 @description
 {@target ts}`import {Directive, ...} from '@angular/core';`{@endtarget}
 {@target js}Available from the `ng.core` namespace{@endtarget}
diff --git a/modules/@angular/docs/cheatsheet/component-configuration.md b/modules/@angular/docs/cheatsheet/component-configuration.md
index 602896bca5..40d11b9833 100644
--- a/modules/@angular/docs/cheatsheet/component-configuration.md
+++ b/modules/@angular/docs/cheatsheet/component-configuration.md
@@ -1,6 +1,6 @@
 @cheatsheetSection
 Component configuration
-@cheatsheetIndex 6
+@cheatsheetIndex 7
 @description
 {@target js}`ng.core.Component` extends `ng.core.Directive`,
 so the `ng.core.Directive` configuration applies to components as well{@endtarget}
@@ -36,17 +36,3 @@ syntax:
 styleUrls: ['my-component.css']`|`styles:`|`styleUrls:`
 description:
 List of inline CSS styles / external stylesheet URLs for styling component’s view.
-
-
-@cheatsheetItem
-syntax:
-`directives: [MyDirective, MyComponent]`|`directives:`
-description:
-List of directives used in the the component’s template.
-
-
-@cheatsheetItem
-syntax:
-`pipes: [MyPipe, OtherPipe]`|`pipes:`
-description:
-List of pipes used in the component's template.
diff --git a/modules/@angular/docs/cheatsheet/dependency-injection.md b/modules/@angular/docs/cheatsheet/dependency-injection.md
index ba597693d7..3f4628fa53 100644
--- a/modules/@angular/docs/cheatsheet/dependency-injection.md
+++ b/modules/@angular/docs/cheatsheet/dependency-injection.md
@@ -1,6 +1,6 @@
 @cheatsheetSection
 Dependency injection configuration
-@cheatsheetIndex 9
+@cheatsheetIndex 10
 @description
 {@target dart}`import 'package:angular2/core.dart';`{@endtarget}
 
diff --git a/modules/@angular/docs/cheatsheet/directive-and-component-decorators.md b/modules/@angular/docs/cheatsheet/directive-and-component-decorators.md
index 3a648d71ed..5da9bb5f70 100644
--- a/modules/@angular/docs/cheatsheet/directive-and-component-decorators.md
+++ b/modules/@angular/docs/cheatsheet/directive-and-component-decorators.md
@@ -1,6 +1,6 @@
 @cheatsheetSection
 Class field decorators for directives and components
-@cheatsheetIndex 7
+@cheatsheetIndex 8
 @description
 {@target ts}`import {Input, ...} from '@angular/core';`{@endtarget}
 {@target js}Available from the `ng.core` namespace{@endtarget}
diff --git a/modules/@angular/docs/cheatsheet/directive-configuration.md b/modules/@angular/docs/cheatsheet/directive-configuration.md
index 584377b123..992f32d04e 100644
--- a/modules/@angular/docs/cheatsheet/directive-configuration.md
+++ b/modules/@angular/docs/cheatsheet/directive-configuration.md
@@ -1,6 +1,6 @@
 @cheatsheetSection
 Directive configuration
-@cheatsheetIndex 5
+@cheatsheetIndex 6
 @description
 {@target ts}`@Directive({ property1: value1, ... })`{@endtarget}
 {@target js}`ng.core.Directive({ property1: value1, ... }).Class({...})`{@endtarget}
diff --git a/modules/@angular/docs/cheatsheet/forms.md b/modules/@angular/docs/cheatsheet/forms.md
index 5603ff9464..131743eed3 100644
--- a/modules/@angular/docs/cheatsheet/forms.md
+++ b/modules/@angular/docs/cheatsheet/forms.md
@@ -1,9 +1,9 @@
 @cheatsheetSection
 Forms
-@cheatsheetIndex 3
+@cheatsheetIndex 4
 @description
-{@target ts}`import {FORM_DIRECTIVES} from '@angular/common';`{@endtarget}
-{@target js}Available from `ng.common.FORM_DIRECTIVES`{@endtarget}
+{@target ts}`import {FormsModule} from '@angular/forms';`{@endtarget}
+{@target js}Available from `ng.forms.FormsModule`{@endtarget}
 {@target dart}Available using `platform_directives` in pubspec{@endtarget}
 
 @cheatsheetItem
diff --git a/modules/@angular/docs/cheatsheet/lifecycle hooks.md b/modules/@angular/docs/cheatsheet/lifecycle hooks.md
index 23e31fcf3e..b397b6947a 100644
--- a/modules/@angular/docs/cheatsheet/lifecycle hooks.md	
+++ b/modules/@angular/docs/cheatsheet/lifecycle hooks.md	
@@ -1,6 +1,6 @@
 @cheatsheetSection
 Directive and component change detection and lifecycle hooks
-@cheatsheetIndex 8
+@cheatsheetIndex 9
 @description
 {@target ts dart}(implemented as class methods){@endtarget}
 {@target js}(implemented as component properties){@endtarget}
diff --git a/modules/@angular/docs/cheatsheet/ngmodules.md b/modules/@angular/docs/cheatsheet/ngmodules.md
new file mode 100644
index 0000000000..0ea119e818
--- /dev/null
+++ b/modules/@angular/docs/cheatsheet/ngmodules.md
@@ -0,0 +1,45 @@
+@cheatsheetSection
+NgModules
+@cheatsheetIndex 1
+@description
+{@target ts js}`import { NgModule } from '@angular/core';`{@endtarget}
+
+@cheatsheetItem
+syntax(ts js):
+`@NgModule({ declarations: ... , imports: ..., exports: ..., bootstrap: ...})
+class MyModule {}`|`NgModule`
+description:
+Defines a module that contains components, directives, pipes and providers.
+
+
+@cheatsheetItem
+syntax(ts js):
+`declarations: [MyRedComponent, MyBlueComponent, MyDatePipe]`|`declarations:`
+description:
+List of components, directives and pipes that belong to this module.
+
+@cheatsheetItem
+syntax(ts js):
+`imports: [BrowserModule, SomeOtherModule]`|`imports:`
+description:
+List of modules that are being imported into this module. Everything from the imported modules will
+be available to `declarations` of this module.
+
+@cheatsheetItem
+syntax(ts js):
+`exports: [MyRedComponent, MyDatePipe]`|`exports:`
+description:
+List of components, directives and pipes that will be visible to modules that import this module.
+
+@cheatsheetItem
+syntax(ts js):
+`providers: [MyService, { provide: ... }]`|`providers:`
+description:
+Array of dependency injection providers visible to contents of this module as well as everyone
+importing this module.
+
+@cheatsheetItem
+syntax(ts js):
+`bootstrap: [MyAppComponent]`|`bootstrap:`
+description:
+Array of components to bootstrap when this module is bootstrapped.
diff --git a/modules/@angular/docs/cheatsheet/routing.md b/modules/@angular/docs/cheatsheet/routing.md
index 93ca73ff05..1f200dd0e5 100644
--- a/modules/@angular/docs/cheatsheet/routing.md
+++ b/modules/@angular/docs/cheatsheet/routing.md
@@ -1,6 +1,6 @@
 @cheatsheetSection
 Routing and navigation
-@cheatsheetIndex 10
+@cheatsheetIndex 11
 @description
 {@target ts}`import {provideRouter, RouteConfig, ROUTER_DIRECTIVES, ...} from '@angular/router';`{@endtarget}
 {@target js}Available from the `ng.router` namespace{@endtarget}
diff --git a/modules/@angular/docs/cheatsheet/template-syntax.md b/modules/@angular/docs/cheatsheet/template-syntax.md
index 1da9687923..17d7bd348b 100644
--- a/modules/@angular/docs/cheatsheet/template-syntax.md
+++ b/modules/@angular/docs/cheatsheet/template-syntax.md
@@ -1,6 +1,6 @@
 @cheatsheetSection
 Template syntax
-@cheatsheetIndex 1
+@cheatsheetIndex 2
 @description
 
 @cheatsheetItem