Please add some additional documentation around the bind function

[aplocher]

There seems to be virtually no documentation about how bind works. It would be great if you incorporated some use cases into the demo.

Also, some additional clarification, such as:

• Will setting the bound value to null or using clearAll cause the binding to get lost?
• Where should the binding be defined (app.js > run for root scope, otherwise controller?)
• Can you accidentally (or intentionally) register multiple bindings on a single property?
• Is the $timeout function call in your example necessary? If so, why?

Thanks

[mortenn]

It also seems my assumption about being able to bind an object is wrong, as doing so seems to make the object inoperable in the angular app, and the bound property in localStorage gets set to null and not updated.