yui/yui3 — comment on commit 4dd435e41f240005cb105adb10530f36a3a7c11b
File:  line 0
By lsmith:

Documentation is a poor replacement for an intuitive API. My point from the ticket stands, that I expect a getter to return the final value.

That said, there are now currently implementations (including some in my code) that are returning an object to work around this. It should be possible to approximate back compat by testing if the getter returns an object, and if so, if that object has the path (regardless of value). This is obviously imprecise.

For the record, I think requiring getters to return top level values is the wrong decision.