Needs documentation

[balupton]

Would be good if this had documentation for:

1. What this actually is
2. How this actually works
3. It's benefits, cons, and tradeoffs
4. How you can use it: www.polymer-project.org/docs/polymer/template.html satisfies this

Specifically, let's take <template repeat="{{i in items}}"> if an item in the middle changes, or is inserted into the middle, does that change the entire view, does it map through everything, then only apply differences, or does it only work with the injected/changed item?

For instance, basic applications would just map through all the items, and redraw each one. Virtual dom users would map through all the items, render them in memory, then apply the diffs to the dom. Advanced users would figure out which things changed exactly, and render only those changes, and only apply those changes to the dom, without touching anything that didn't change.

[ebidel]

There's a whole page on how the data binding system works: http://www.polymer-project.org/docs/polymer/databinding-advanced.html

[balupton]

It would be nice if that url was the url of this github project. So we don't have to go searching for it.