diff --git a/.github/ISSUE_TEMPLATE.md b/.github/ISSUE_TEMPLATE.md
index 1b9d193ceb..9a47c60f37 100644
--- a/.github/ISSUE_TEMPLATE.md
+++ b/.github/ISSUE_TEMPLATE.md
@@ -14,7 +14,7 @@ Please submit Angular Material and CDK questions
[here](https://groups.google.com/forum/#!forum/angular-material2)
and issues [here](https://github.com/angular/components/issues).
-->
-## Bug, enhancement request, or proposal
+## Bug, Enhancement Request, or Proposal
@@ -45,6 +45,7 @@ and issues [here](https://github.com/angular/components/issues).
- AngularJS Material: 1.
- OS:
- Browsers:
+- Screen Readers:
### Add anything else we should know
diff --git a/README.md b/README.md
index a030521a6b..9b28ad8ff0 100644
--- a/README.md
+++ b/README.md
@@ -28,20 +28,20 @@ Quick Links:
* [Installing](#installing)
-Please note that using AngularJS Material requires the use of **[AngularJS](https://angularjs.org/)
-1.4.x** or higher.
+Please note that using the latest version of AngularJS Material requires the use of
+**[AngularJS](https://angularjs.org/) 1.7.2** or higher.
-AngularJS Material is targeted for the browser versions defined in the `browserslist` field
-of our [package.json](package.json). Below is a screenshot from
-[browserl.ist](http://browserl.ist/?q=%3E+0.5%25%2C+last+2+versions%2C+Firefox+ESR%2C+not+ie+%3C%3D+10%2C+not+ie_mob+%3C%3D+10%2C+not+bb+%3C%3D+10%2C+not+op_mob+%3C%3D+12.1)
-that provides a visual representation of this configuration:
+AngularJS Material supports the browser versions defined in the `browserslist` field
+of our [package.json](package.json). Find out more on our
+[docs site](https://material.angularjs.org/latest/#browser-support).
-
+AngularJS Material supports the screen reader versions listed
+[here](https://material.angularjs.org/latest/#screen-reader-support).
## Online Documentation and Demos
-
+
- Visit [material.angularjs.org](https://material.angularjs.org/) online to review the API, see the
@@ -73,8 +73,8 @@ The minor builds (1.1.0, 1.2.0, 1.3.0) can contain breaking changes to CSS, APIs
Our formal release of `minor` builds is much less frequent. The release process for `minor` builds is currently
being re-evaluated.
-> For the purposes of AngularJS Material, you *could* think of the patch releases as being *minor* changes
-and the 'minor' releases as being *major* changes according to semver.
+> For the purposes of AngularJS Material, you *could* think of the patch releases as being *minor* changes,
+ and the 'minor' releases as being *major* changes according to semver.
## Contributing
@@ -95,7 +95,7 @@ It is important to note that for each release, the [ChangeLog](CHANGELOG.md) is
itemize all:
- Bug Fixes
-- New Features
+- New Enhancements
- Breaking Changes
## Building
@@ -108,6 +108,12 @@ First install or update your local project's **npm** dependencies:
npm install
```
+Install Gulp v3 globally:
+
+```bash
+npm install -g gulp@3
+```
+
Then run the **gulp** tasks:
```bash
@@ -148,23 +154,22 @@ npm install http://github.com/angular/bower-material#master --save
#### Other Dependency Managers
Visit our [distribution repository](https://github.com/angular/bower-material/blob/master/README.md)
-for more details on how to install and use the AngularJS Material distribution
-files within your local project.
+for more details on how to install and use the AngularJS Material distribution files within your local
+project.
#### CDN
CDN versions of AngularJS Material are available.
-With the Google CDN, you will not need to download local copies of the distribution files. Instead
+With the Google CDN, you will not need to download local copies of the distribution files. Instead,
simply reference the CDN urls to easily use those remote library files. This is especially useful
-when using online tools such as [CodePen](http://codepen.io/), [Plunker](http://plnkr.co/), or
-[JSFiddle](http://jsfiddle.net/).
+when using online tools such as [CodePen](http://codepen.io/) or [Plunker](http://plnkr.co/).
```html
-
-
+
+
@@ -175,8 +180,8 @@ when using online tools such as [CodePen](http://codepen.io/), [Plunker](http://
-
-
+
+
```
@@ -204,7 +209,8 @@ pull directly from our [distribution repository](https://github.com/angular/bowe
```
-Once you have all the necessary assets installed, add `ngMaterial` and `ngMessages` as dependencies for your app:
+Once you have all the necessary assets installed, add `ngMaterial` and `ngMessages` as dependencies for your
+app:
```javascript
angular.module('myApp', ['ngMaterial', 'ngMessages']);
diff --git a/docs/app/partials/home.tmpl.html b/docs/app/partials/home.tmpl.html
index 3b4be74eb8..fa014dcb2f 100644
--- a/docs/app/partials/home.tmpl.html
+++ b/docs/app/partials/home.tmpl.html
@@ -130,7 +130,7 @@
+ 