webcomponents.js-dev
====================

Web Component polyfills development respository.

Production distributions may be built using gulp. Pre-built versions are 
available at https://github.com/Polymer/webcomponentsjs.

webcomponents.js
================

A suite of polyfills supporting the HTML web components specs:

**Custom Elements**: allows authors to define their own custom tags ([spec](https://w3c.github.io/webcomponents/spec/custom/)).

**HTML Imports**: a way to include and reuse HTML documents via other HTML documents ([spec](https://w3c.github.io/webcomponents/spec/imports/)).

**Shadow DOM**: provides encapsulation by hiding DOM subtrees under shadow roots ([spec](https://w3c.github.io/webcomponents/spec/shadow/)).

This also folds in polyfills for `MutationObserver` and `WeakMap`.


# Builds

There are two builds of these polyfills:

`webcomponents.js` includes all of the polyfills.

`webcomponents-lite.js` includes all polyfills except for shadow DOM.

Update the readme to include @addyosmani's notes
Update the readme to include @addyosmani's notes
