From 719d3cc2831b910788c3e78e55fe9917cef05901 Mon Sep 17 00:00:00 2001
From: Jeremy Elbourn <jelbourn@google.com>
Date: Sat, 8 Apr 2017 17:46:12 -0600
Subject: [PATCH] chore: update getting-started guide for beta.3

No longer mentions `MaterialModule` and instead offers some guidance on building your own NgModule for Angular Material components.
---
 guides/getting-started.md | 37 +++++++++++++++++++++++++------------
 guides/theming.md         |  3 ++-
 2 files changed, 27 insertions(+), 13 deletions(-)

diff --git a/guides/getting-started.md b/guides/getting-started.md
index 202ed5e12e6c..e9b69f9f6133 100644
--- a/guides/getting-started.md
+++ b/guides/getting-started.md
@@ -43,22 +43,36 @@ import {NoopAnimationsModule} from '@angular/platform-browser/animations';
 export class PizzaPartyAppModule { }
 ```
 
-## Step 3: Import the Module
+## Step 3: Import the component modules
 
-Add MaterialModule as an import in your app's root NgModule.
+Import the NgModule for each component you want to use: 
 
 ```ts
-import {MaterialModule} from '@angular/material';
+import {MdButtonModule, MdCheckboxModule} from '@angular/material';
 
 @NgModule({
   ...
-  imports: [MaterialModule],
+  imports: [MdButtonModule, MdCheckboxModule],
   ...
 })
 export class PizzaPartyAppModule { }
 ```
 
-## Step 4: Include Theming
+Alternatively, you can create a separate NgModule that imports all of the 
+Angular Material components that you will use in your application. You can then
+include this module wherever you'd like to use the components.
+
+```ts
+import {MdButtonModule, MdCheckboxModule} from '@angular/material';
+
+@NgModule({
+  imports: [MdButtonModule, MdCheckboxModule],
+  exports: [MdButtonModule, MdCheckboxModule],
+})
+export class MyOwnCustomMaterialModule { }
+```
+
+## Step 4: Include a theme
 
 Including a theme is **required** to apply all of the core and theme styles to your application.
 
@@ -95,8 +109,8 @@ import 'hammerjs';
 
 ## Step 6 (Optional): Add Material Icons
 
-If you want your `md-icon` components to use [Material Icons](https://material.io/icons/),
-load the font in your `index.html`.
+If you want to use the `md-icon` component with the official 
+[Material Design Icons](https://material.io/icons/), load the icon font in your `index.html`.
 
 ```html
 <link href="https://fonts.googleapis.com/icon?family=Material+Icons" rel="stylesheet">
@@ -105,11 +119,10 @@ load the font in your `index.html`.
 For more information on using Material Icons, check out the
 [Material Icons Guide](https://google.github.io/material-design-icons/).
 
-Note that `md-icon` has support for any font or svg icons, so using Material Icons is
-just one option.
+Note that `md-icon` supports any font or svg icons; using Material Icons is one of many options.
 
 
-## Configuring SystemJS
+## Appendix: Configuring SystemJS
 
 If your project is using SystemJS for module loading, you will need to add `@angular/material`
 to the SystemJS configuration:
@@ -118,9 +131,9 @@ to the SystemJS configuration:
 System.config({
   // existing configuration options
   map: {
-    ...
+    // ...
     '@angular/material': 'npm:@angular/material/bundles/material.umd.js',
-    ...
+    // ...
   }
 });
 ```
diff --git a/guides/theming.md b/guides/theming.md
index c9e902020b15..390c51b8f316 100644
--- a/guides/theming.md
+++ b/guides/theming.md
@@ -134,7 +134,8 @@ With this, any element inside of a parent with the `unicorn-dark-theme` class wi
 dark theme.
 
 ### Theming your own components
-For more details about theming your own components, see [theming-your-components.md](https://github.com/angular/material2/blob/master/guides/theming-your-components.md)
+For more details about theming your own components, 
+see [theming-your-components.md](./theming-your-components.md)
 
 ### Future work
 * Once CSS variables (custom properties) are available in all the browsers we support,