updated documentation, and changed the callback params to match the Object.watch's callback from the implementation standard