Document observe block

[sorvell]

Added here: Polymer/polymer@3a749f8

[ebidel]

There's a lot going on in this CL. The important part is the observe block
to define path observation in an object? As used here:

https://github.com/Polymer/polymer/blob/3a749f848ee6374fe57822b1923ad40b572648b8/test/html/property-observe.html#L19:L23

Is it also worth documenting Path.get() (and anything else Path
provides)?

On Thu, Oct 17, 2013 at 4:25 PM, Steve Orvell [email protected]:

Added here: Polymer/polymer@3a749f8Polymer/polymer@3a749f8

—
Reply to this email directly or view it on GitHubhttps://github.com//issues/173
.

[ebidel]

@sorvell please look this over. There's a third param passed to the custom observer callback (an array of arrays)? What is that?

[sorvell]

When multiple properties result in 1 observer firing, the arguments are incorrect (Polymer/polymer#321). The last argument is a stopgap. It's the list of all change info, and it can be iterated through to discover the missing old values. We probably shouldn't doc this since it's going to be improved shortly.

Otherwise, looks good.