It's confusing that you need to nest a <template repeat> inside an outermost <template>.

[ojanvafai]

All the examples on http://www.polymer-project.org/platform/template.html don't show that you need to do this.

1. The docs should be updated to explicitly point this out. Probably at the beginning of the template binding page.
2. If you put a "repeat" or an "if" on the outermost template in a custom element, we should log a warning to the console clearly explaining why it's ignored.

@rafaelw

[sjmiles]

Sorry about that, we had a blindspot there.

We will add a warning as you suggest, and then consider other possibilities in the longer term (e.g. auto generating an enclosing template, or using some other name for the outer template).

[ebidel]

The outmost <template> a requirement imposed by polymer-element and not by Template Binding.

Better data-binding examples higher up in the doc stack will help, especially using it the context of a custom element.
Polymer/old-docs-site#98

[sorvell]

Dup of #703