API Documentation Does Not Include Whether or Not A Given Property Will Generate KVO Change Notifications

Originator:jaredtsinclair
Number:rdar://15832314 Date Originated:January 15, 2014
Status:Open Resolved:
Product:Documentation Product Version:
Classification:Enhancement Reproducible:Always
 
Summary:
API Documentation Does Not Include Whether or Not A Given Property Will Generate KVO Change Notifications. It would be helpful to know ahead of time if a given property of an NSObject subclass — any of them — will generate observable KVO change notifications.

Steps to Reproduce:
For example, the `state` property of NSURLSessionTask is observable via KVO, which could have many possible uses, such as tracking an active task count across an application in order to update the status bar activity indicator on iOS.

Expected Results:
In the documentation for each property, a there should be a brief note about whether that property supports KVO. Even just a simple yes or no would suffice.

Actual Results:
Property documentation does not specify which, if any, properties support KVO.

Comments


Please note: Reports posted here will not necessarily be seen by Apple. All problems should be submitted at bugreport.apple.com before they are posted here. Please only post information for Radars that you have filed yourself, and please do not include Apple confidential information in your posts. Thank you!