Update READMEs

Add verbiage around experimental status of component set, as well as
overall project status.

README.md

@@ -1,6 +1,6 @@
 # Material Web Components
 
-> :warning: These components are still a work in progress. Not all elements are available on NPM yet. We are working on the remaining elements and publish them to the NPM registry once we have a first working version. :warning:
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
 
 Material Web Components helps developers execute [Material Design](https://www.material.io) using [web components](https://developer.mozilla.org/en-US/docs/Web/Web_Components).
 

packages/base/README.md

@@ -1,2 +1,5 @@
 # mwc-base
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A suite of shared libraries and utility functions for [Material Components](https://material.io/components/)[Web Components](https://www.webcomponents.org/introduction)

packages/button/README.md

@@ -1,4 +1,7 @@
 # mwc-button
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/components/) icon implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/checkbox/README.md

@@ -1,4 +1,7 @@
 # mwc-checkbox
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/components/) icon implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/drawer/README.md

@@ -1,4 +1,7 @@
 # mwc-drawer
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/develop/) drawer implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/fab/README.md

@@ -1,4 +1,7 @@
 # mwc-fab
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/components/) icon implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/formfield/README.md

@@ -1,4 +1,7 @@
 # mwc-formfield
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/components/) formfield implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/icon-button/README.md

@@ -0,0 +1,64 @@
+# mwc-icon-button
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
+A [Material Components](https://material.io/components/) icon implementation using [Web Components](https://www.webcomponents.org/introduction)
+
+## Getting started
+
+ * The easiest way to try out mwc-icon-button is to use one of these online tools:
+
+    * Runs in all [supported](#supported-browsers) browsers: [StackBlitz](https://stackblitz.com/edit/mwc-icon-example?file=index.js), [Glitch](https://glitch.com/edit/#!/mwc-icon-example?path=index.html)
+
+    * Runs in browsers with [JavaScript Modules](https://caniuse.com/#search=modules): [JSBin](http://jsbin.com/qibisux/edit?html,output),
+    [CodePen](https://codepen.io/azakus/pen/deZLja).
+
+* You can also copy [this HTML file](https://gist.githubusercontent.com/azakus/f01e9fc2ed04e781ad5a52ded7b296e7/raw/266f2f4f91cbfe89b2acc6ec63957b1a3cfe9b39/index.html) into a local file and run it in any browser that supports [JavaScript Modules]((https://caniuse.com/#search=modules)).
+
+* When you're ready to use mwc-icon-button in a project, install it via [npm](https://www.npmjs.com/). To run the project in the browser, a module-compatible toolctain is required. We recommend installing the [Polymer CLI](https://github.com/Polymer/polymer-cli) and using its development server as follows.
+
+  1. Ensure the webcomponents polyfills are included in your HTML page
+
+      - Install webcomponents polyfills
+
+          ```npm i @webcomponents/webcomponentsjs```
+
+      - Add webcomponents polyfills to your HTML page
+
+          ```<script src="@webcomponents/webcomponentsjs/webcomponents-loader.js"></script>```
+
+  1. Add mwc-icon-button to your project:
+
+      ```npm i @material/mwc-icon-button```
+
+  1. Import the mwc-icon-button definition into your HTML page:
+
+      ```<script type="module" src="@material/mwc-icon-button/index.js"></script>```
+
+      Or into your module script:
+
+      ```import {IconButton} from "@material/mwc-icon-button"```
+
+  1. Create an instance of mwc-icon-button in your HTML page, or via any framework that [supports rendering Custom Elements](https://custom-elements-everywhere.com/):
+
+      ```<mwc-icon-button icon="sentiment_very_satisfied" offIcon="sentiment_very_dissatisfied"></mwc-icon-button>```
+
+  1. Install the Polymer CLI:
+
+      ```npm i -g polymer-cli```
+
+  1. Run the development server and open a browser pointing to its URL:
+
+      ```polymer serve```
+
+  > mwc-icon-button is published on [npm](https://www.npmjs.com/package/@material/mwc-icon-button) using JavaScript Modules.
+  This means it can take advantage of the standard native JavaScript module loader available in all current major browsers.
+  >
+  > However, since mwc-icon-button uses npm convention to reference dependencies by name, a light transform to rewrite specifiers to URLs is required to get it to run in the browser. The polymer-cli's development server `polymer serve` automatically handles this transform.
+
+  Tools like [WebPack](https://webpack.js.org/) and [Rollup](https://rollupjs.org/) can also be used to serve and/or bundle mwc-icon-button.
+
+## Supported Browsers
+
+The last 2 versions of all modern browsers are supported, including
+Chrome, Safari, Opera, Firefox, Edge. In addition, Internet Explorer 11 is also supported.

packages/icon/README.md

@@ -1,4 +1,7 @@
 # mwc-icon
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/components/) icon implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/linear-progress/README.md

@@ -0,0 +1,64 @@
+# mwc-linear-progress
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
+A [Material Components](https://material.io/components/) icon implementation using [Web Components](https://www.webcomponents.org/introduction)
+
+## Getting started
+
+ * The easiest way to try out mwc-linear-progress is to use one of these online tools:
+
+    * Runs in all [supported](#supported-browsers) browsers: [StackBlitz](https://stackblitz.com/edit/mwc-icon-example?file=index.js), [Glitch](https://glitch.com/edit/#!/mwc-icon-example?path=index.html)
+
+    * Runs in browsers with [JavaScript Modules](https://caniuse.com/#search=modules): [JSBin](http://jsbin.com/qibisux/edit?html,output),
+    [CodePen](https://codepen.io/azakus/pen/deZLja).
+
+* You can also copy [this HTML file](https://gist.githubusercontent.com/azakus/f01e9fc2ed04e781ad5a52ded7b296e7/raw/266f2f4f91cbfe89b2acc6ec63957b1a3cfe9b39/index.html) into a local file and run it in any browser that supports [JavaScript Modules]((https://caniuse.com/#search=modules)).
+
+* When you're ready to use mwc-linear-progress in a project, install it via [npm](https://www.npmjs.com/). To run the project in the browser, a module-compatible toolctain is required. We recommend installing the [Polymer CLI](https://github.com/Polymer/polymer-cli) and using its development server as follows.
+
+  1. Ensure the webcomponents polyfills are included in your HTML page
+
+      - Install webcomponents polyfills
+
+          ```npm i @webcomponents/webcomponentsjs```
+
+      - Add webcomponents polyfills to your HTML page
+
+          ```<script src="@webcomponents/webcomponentsjs/webcomponents-loader.js"></script>```
+
+  1. Add mwc-linear-progress to your project:
+
+      ```npm i @material/mwc-linear-progress```
+
+  1. Import the mwc-linear-progress definition into your HTML page:
+
+      ```<script type="module" src="@material/mwc-linear-progress/index.js"></script>```
+
+      Or into your module script:
+
+      ```import {LinearProgress} from "@material/mwc-linear-progress"```
+
+  1. Create an instance of mwc-linear-progress in your HTML page, or via any framework that [supports rendering Custom Elements](https://custom-elements-everywhere.com/):
+
+      ```<mwc-linear-progress determinate progress="0.5" buffer="1"></mwc-linear-progress>```
+
+  1. Install the Polymer CLI:
+
+      ```npm i -g polymer-cli```
+
+  1. Run the development server and open a browser pointing to its URL:
+
+      ```polymer serve```
+
+  > mwc-linear-progress is published on [npm](https://www.npmjs.com/package/@material/mwc-linear-progress) using JavaScript Modules.
+  This means it can take advantage of the standard native JavaScript module loader available in all current major browsers.
+  >
+  > However, since mwc-linear-progress uses npm convention to reference dependencies by name, a light transform to rewrite specifiers to URLs is required to get it to run in the browser. The polymer-cli's development server `polymer serve` automatically handles this transform.
+
+  Tools like [WebPack](https://webpack.js.org/) and [Rollup](https://rollupjs.org/) can also be used to serve and/or bundle mwc-linear-progress.
+
+## Supported Browsers
+
+The last 2 versions of all modern browsers are supported, including
+Chrome, Safari, Opera, Firefox, Edge. In addition, Internet Explorer 11 is also supported.

packages/radio/README.md

@@ -1,4 +1,7 @@
 # mwc-radio
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/components/) icon implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/ripple/README.md

@@ -1,4 +1,7 @@
 # mwc-ripple
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/components/) icon implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/slider/README.md

@@ -1,4 +1,7 @@
 # mwc-slider
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/components/) icon implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/snackbar/README.md

@@ -1,4 +1,7 @@
 # mwc-snackbar
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/components/) icon implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/switch/README.md

@@ -1,4 +1,7 @@
 # mwc-switch
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/components/) icon implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/tab-bar/README.md

@@ -1,4 +1,7 @@
 # mwc-tab-bar
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/develop/) tab-bar implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/tab-indicator/README.md

@@ -1,4 +1,7 @@
 # mwc-tab-indicator
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/develop/) tab indicator implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/tab-scroller/README.md

@@ -1,4 +1,7 @@
 # mwc-tab-scroller
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/develop/) tab scroller implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/tab/README.md

@@ -1,4 +1,7 @@
 # mwc-tab
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/develop/) tab implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started

packages/top-app-bar/README.md

@@ -1,4 +1,7 @@
 # mwc-top-app-bar
+
+> :warning: These components are a work in progress. They are pre-release and should be considered experimental, as they may undergo major changes before release. We are experimenting with alternate architectures and approaches with the goal of allowing us to bring the most correct and optimal implementation of Material components to the widest possible audiences. Visible progress may be slow, as this research is across teams and repositories so is not consistently reflected in commits to this codebase. :warning:
+
 A [Material Components](https://material.io/develop/) top app bar implementation using [Web Components](https://www.webcomponents.org/introduction)
 
 ## Getting started