Appledocs for public interface

Issue #25 
Add a `@note` about the selector's parameter structure. If the selector accepts an `id` parameter, it will be passed the new value for the key that changed.