first draft of polymer element tutorial

almost first draft of polymer target


BUG=
R=jmesserly@google.com, kathyw@google.com

Committed: de5f3ca

[mem, 2013-09-20 21:04:31]

Hi all:
First draft of a tutorial about Dart Polymer elements. Looking forward to your
insights. 

Probably most easily reviewed from:

https://tute-polymer-review-dot-dart-lang.appspot.com/docs/tutorials/polymer/

Thanks.
mem

[sethladd, 2013-09-20 23:18:35]

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
File src/site/docs/tutorials/polymer/index.markdown (right):

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:48: whose primary aim is to help
manage the complexity
This sounds like we're speaking for polymer project. I'm not sure the polymer
project would state this as their primary aim.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:73: the area within the black
rectangle is implemented by a Polymer element,
there are two black rectangles

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:84: To place this Polymer element
on an HTML page, you write:
you also need to import it

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:98: The contents of the Polymer
element are hidden in the *shadow DOM*.
define shadow dom here, or omit because you don't show the contents anyway

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:177: **Note:** Use this script in
lieu of `packages/browser/dart.js`.
concerned that in lieu will be difficult for non-english speakers.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:201: in `tute-stopwatch.html`.
use underscore instead of dash

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:367: When the Timer fires, it
calls the `updateTImer` callback function,
typo

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:385: * {% raw %}
`{{myFunction()}}` {% endraw %}--function calls
let's not mention function calls here. not a great practice to encourage

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:407: * detail [xx] has some vague
use I'm uncertain of.
an object can be attached to the event. it's the "detail". not all events have a
detail object.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:416: ##Querying the Shadow DOM
{#in-the-shadows}
I'd like to delay talking about or mentioning shadow dom as long as possible.
but it's very important.

[Jennifer Messerly, 2013-09-24 02:36:38]

This is soooooooooooo cool. Just a few minor comments.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
File src/site/docs/tutorials/polymer/index.markdown (right):

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:48: whose primary aim is to help
manage the complexity
On 2013/09/20 23:18:36, sethladd wrote:
> This sounds like we're speaking for polymer project. I'm not sure the polymer
> project would state this as their primary aim.

borrow some language from "Guiding principals" on polymer-project.org?

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:75: <strong>Try it!</strong>
FYI -- the example didn't work for me, but it worked when I went to the link.
Some sort of cross-domain issue with the appspot test URL?

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:304: the class must also use
ObservableMixin.
this will be fixed soon! this week or next. I've added it to my local copy of:
https://codereview.chromium.org/24149003/

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:366: The stopwatch element uses a
periodic Timer to fire an event every second.
link to API docs for Timer?

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:385: * {% raw %}
`{{myFunction()}}` {% endraw %}--function calls
On 2013/09/20 23:18:36, sethladd wrote:
> let's not mention function calls here. not a great practice to encourage

mention filters? that's a good time to include function calls.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:452: ![Scoped CSS
styleing](images/css-styling.png)
"Scoped CSS styling"?

[Jennifer Messerly, 2013-09-24 02:36:48]

lgtm

[ericbidelman, 2013-09-24 18:18:41]

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
File src/site/docs/tutorials/polymer/index.markdown (right):

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:11: prev-title: "Define a Custom
DOM Tag"
"Define a Custom HTML Element"

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:54: encapsulating appearance
and/or behavior within semantically meaningful DOM tags.
DOM tags -> HTML elements

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:72: In the example running below,
is a custom element, implemented using Polymer.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:133: app and its use of Polymer
elements.
There's a lot mentions of "Polymer elements", but I'd like to see more use of
"custom elements".
That's what we're trying to highlight (the standards part). Polymer just gives
you some extras.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:196: Use `link` to import the
HTML definition file as shown.
`link[rel="import"]` to be clear

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:200: The definition for the
tute-stopwatch element is
<tute-stopwatch>

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:228: for example a [xx].
are these placeholders?

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:246: The template comprises any
valid HTML code within the &lt;template&gt; tag.
It's important to note here that Polymer takes the first <template> it finds in
the element
and creates a shadow root from it. When the element is instantiated, the
template isn't
rendered, but an instance of the element is created from it.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:248: The template can also
include scoped CSS styles within a &lt;style&gt; tag.
FYI, the styles are scoped by default.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:253: For Polymer elements, the
Dart script is a Dart class
Can Polymer.dart do inline <script>?

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:271: More about scoped CSS in
[Styling a Polymer element](#scoped-css).
Suggset you also link to this article:
http://www.polymer-project.org/articles/styling-elements.html

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:273: The rest of the code within
the template tag
<template>

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:276: * {% raw %}`{{counter}}`{%
endraw %}--a Polymer syntax for
"a mustache for data binding"

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:279: * `on-click`--a Polymer
element attribute that lets you
"a Polymer element attribute" -> a Polymer `on-*`declarative event mapping
(http://www.polymer-project.org/polymer.html#declarative-event-mapping)

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:325: [querying its shadow
DOM](#in-the-shadows).
Do you guys have
http://www.polymer-project.org/polymer.html#automatic-node-finding? We recommend
people use that instead of querying the shadow dom directly.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:339: The inserted() method is one
of four Polymer element life-cycle methods:
FYI: the lifecycle methods have been renamed. See
http://www.polymer-project.org/polymer.html#lifecyclemethods

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:356: ##Embedding live data on the
page {#one-way-data-binding}
I think the title is misleading. "Using two-way data binding" ?

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:424: (unless the Polymer element
chooses to reveal them).
Not sure what you mean here. Shadow roots are discoverable no mater what (e.g.
element.shadowRoot).

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:428: You can programmatically get
items from the shadow DOM
Be consistent with "Shadow DOM" capitalization.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:438: The getShadowRoot function
returns the shadow root element
`getShadowRoot`

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:439: for 'this' instance of the
element named.
`this`

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:450: which apply only to the
contents of the Polymer element.
You can also style the element directly using `@host{}`. See my article I linked
to above.

[Jennifer Messerly, 2013-09-24 18:30:06]

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
File src/site/docs/tutorials/polymer/index.markdown (right):

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:325: [querying its shadow
DOM](#in-the-shadows).
On 2013/09/24 18:18:42, ericbidelman wrote:
> Do you guys have
> http://www.polymer-project.org/polymer.html#automatic-node-finding? We
recommend
> people use that instead of querying the shadow dom directly. 

not yet. This change is landing soon: https://codereview.chromium.org/24149003/
... it will have (almost) everything in Polymer as of ~1 wk ago.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:339: The inserted() method is one
of four Polymer element life-cycle methods:
On 2013/09/24 18:18:42, ericbidelman wrote:
> FYI: the lifecycle methods have been renamed. See
> http://www.polymer-project.org/polymer.html#lifecyclemethods

yup. We'll have to fix this once a few of our code changes land. I think mem is
trying to document what works right now.

[mem, 2013-10-01 16:05:30]

Thank you all for your comments.
I got most of them incorporated.

Some issues will be changing in John's next release later in the week, so I'll
have to wait on those.

Kathy: do you want to review this or shall I move on?

Thanks.
mem

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
File src/site/docs/tutorials/polymer/index.markdown (right):

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:11: prev-title: "Define a Custom
DOM Tag"
On 2013/09/24 18:18:42, ericbidelman wrote:
> "Define a Custom HTML Element"

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:48: whose primary aim is to help
manage the complexity
I got this language from their website.
Changed it up (again with language from their website).

On 2013/09/20 23:18:36, sethladd wrote:
> This sounds like we're speaking for polymer project. I'm not sure the polymer
> project would state this as their primary aim.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:54: encapsulating appearance
and/or behavior within semantically meaningful DOM tags.
On 2013/09/24 18:18:42, ericbidelman wrote:
> DOM tags -> HTML elements

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:72: In the example running below,
On 2013/09/24 18:18:42, ericbidelman wrote:
> is a custom element, implemented using Polymer.

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:73: the area within the black
rectangle is implemented by a Polymer element,
On 2013/09/20 23:18:36, sethladd wrote:
> there are two black rectangles

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:75: <strong>Try it!</strong>
The link here is actually the Web UI version of this app. I haven't yet figured
out how to deploy the Polymer version. So ... under construction.

On 2013/09/24 02:36:39, John Messerly wrote:
> FYI -- the example didn't work for me, but it worked when I went to the link.
> Some sort of cross-domain issue with the appspot test URL?

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:84: To place this Polymer element
on an HTML page, you write:
On 2013/09/20 23:18:36, sethladd wrote:
> you also need to import it

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:98: The contents of the Polymer
element are hidden in the *shadow DOM*.
On 2013/09/20 23:18:36, sethladd wrote:
> define shadow dom here, or omit because you don't show the contents anyway

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:133: app and its use of Polymer
elements.
Changed Polymer elements -> custom elements everywhere.

On 2013/09/24 18:18:42, ericbidelman wrote:
> There's a lot mentions of "Polymer elements", but I'd like to see more use of
> "custom elements".
> That's what we're trying to highlight (the standards part). Polymer just gives
> you some extras.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:177: **Note:** Use this script in
lieu of `packages/browser/dart.js`.
On 2013/09/20 23:18:36, sethladd wrote:
> concerned that in lieu will be difficult for non-english speakers.

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:196: Use `link` to import the
HTML definition file as shown.
On 2013/09/24 18:18:42, ericbidelman wrote:
> `link[rel="import"]` to be clear

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:200: The definition for the
tute-stopwatch element is
On 2013/09/24 18:18:42, ericbidelman wrote:
> <tute-stopwatch>

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:201: in `tute-stopwatch.html`.
On 2013/09/20 23:18:36, sethladd wrote:
> use underscore instead of dash

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:228: for example a [xx].
Yes they are. Was hoping for a suggestion!

On 2013/09/24 18:18:42, ericbidelman wrote:
> are these placeholders?

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:246: The template comprises any
valid HTML code within the &lt;template&gt; tag.
Reworded. Avoided using the term shadow root here.

On 2013/09/24 18:18:42, ericbidelman wrote:
> It's important to note here that Polymer takes the first <template> it finds
in
> the element
> and creates a shadow root from it. When the element is instantiated, the
> template isn't
> rendered, but an instance of the element is created from it.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:248: The template can also
include scoped CSS styles within a &lt;style&gt; tag.
On 2013/09/24 18:18:42, ericbidelman wrote:
> FYI, the styles are scoped by default. 

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:253: For Polymer elements, the
Dart script is a Dart class
Yes. But our tools don't give good info when editing so best to put it in a
separate file.

On 2013/09/24 18:18:42, ericbidelman wrote:
> Can Polymer.dart do inline <script>?

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:271: More about scoped CSS in
[Styling a Polymer element](#scoped-css).
On 2013/09/24 18:18:42, ericbidelman wrote:
> Suggset you also link to this article:
> http://www.polymer-project.org/articles/styling-elements.html

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:273: The rest of the code within
the template tag
On 2013/09/24 18:18:42, ericbidelman wrote:
> <template>

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:276: * {% raw %}`{{counter}}`{%
endraw %}--a Polymer syntax for
Included reference to mustaches, but worded it differently.
On 2013/09/24 18:18:42, ericbidelman wrote:
> "a mustache for data binding"

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:279: * `on-click`--a Polymer
element attribute that lets you
On 2013/09/24 18:18:42, ericbidelman wrote:
> "a Polymer element attribute" -> a Polymer `on-*`declarative event mapping
> (http://www.polymer-project.org/polymer.html#declarative-event-mapping)

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:356: ##Embedding live data on the
page {#one-way-data-binding}
On 2013/09/24 18:18:42, ericbidelman wrote:
> I think the title is misleading. "Using two-way data binding" ?

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:366: The stopwatch element uses a
periodic Timer to fire an event every second.
On 2013/09/24 02:36:39, John Messerly wrote:
> link to API docs for Timer?

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:367: When the Timer fires, it
calls the `updateTImer` callback function,
On 2013/09/20 23:18:36, sethladd wrote:
> typo

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:385: * {% raw %}
`{{myFunction()}}` {% endraw %}--function calls
changed the name to make it look like a filter. Does this work?

On 2013/09/24 02:36:39, John Messerly wrote:
> On 2013/09/20 23:18:36, sethladd wrote:
> > let's not mention function calls here. not a great practice to encourage
> 
> mention filters? that's a good time to include function calls.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:407: * detail [xx] has some vague
use I'm uncertain of.
On 2013/09/20 23:18:36, sethladd wrote:
> an object can be attached to the event. it's the "detail". not all events have
a
> detail object.

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:416: ##Querying the Shadow DOM
{#in-the-shadows}
I've got all the shadow dom stuff isolated here in this section now.
I have to say something as the example code uses getShadowRoot.
On 2013/09/20 23:18:36, sethladd wrote:
> I'd like to delay talking about or mentioning shadow dom as long as possible.
> but it's very important.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:424: (unless the Polymer element
chooses to reveal them).
On 2013/09/24 18:18:42, ericbidelman wrote:
> Not sure what you mean here. Shadow roots are discoverable no mater what (e.g.
> element.shadowRoot).

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:428: You can programmatically get
items from the shadow DOM
On 2013/09/24 18:18:42, ericbidelman wrote:
> Be consistent with "Shadow DOM" capitalization.

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:438: The getShadowRoot function
returns the shadow root element
On 2013/09/24 18:18:42, ericbidelman wrote:
> `getShadowRoot`

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:439: for 'this' instance of the
element named.
On 2013/09/24 18:18:42, ericbidelman wrote:
> `this`

Done.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:450: which apply only to the
contents of the Polymer element.


I couldn't get this to work.

On 2013/09/24 18:18:42, ericbidelman wrote:
> You can also style the element directly using `@host{}`. See my article I
linked
> to above.

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:452: ![Scoped CSS
styleing](images/css-styling.png)
On 2013/09/24 02:36:39, John Messerly wrote:
> "Scoped CSS styling"?

Done.

[mem, 2013-10-03 17:01:53]

PTAL.

I incorporated Kathy's review comments from a paper review, made another edit
pass, updated the code and diagrams...

Thank you!
mem

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
File src/site/docs/tutorials/polymer/index.markdown (right):

https://chromiumcodereview.appspot.com/24269013/diff/34001/src/site/docs/tuto...
src/site/docs/tutorials/polymer/index.markdown:450: which apply only to the
contents of the Polymer element.
Got it done now.
Adjusted the example and text.
On 2013/10/01 16:05:31, mem wrote:
> 
> 
> I couldn't get this to work.
> 
> On 2013/09/24 18:18:42, ericbidelman wrote:
> > You can also style the element directly using `@host{}`. See my article I
> linked
> > to above.
>

[Kathy Walrath, 2013-10-04 17:22:46]

lgtm

[mem, 2013-10-04 19:10:52]

Committed patchset #11 manually as rde5f3ca (presubmit successful).