Core Data Programming Guide does not include information about queue confinement

Originator:quellish
Number:rdar://14310967 Date Originated:Sat, 29 Jun 2013 04:08:34 GMT
Status:Open Resolved:
Product:Documentation Product Version:
Classification: Reproducible:Always
 
Summary:
iOS 5 introduced queue confinement for managing the concurrency of NSManagedObjectContexts. To use this functionality developers must submit blocks to the context using performBlock: or performBlockAndWait: . This is currently best documented in the iOS 5 release notes:
http://developer.apple.com/library/ios/#releasenotes/General/WhatsNewIniOS/Articles/iOS5.html
And in 2011 and 2012 WWDC Core Data sessions.

Queue confinement is not covered at all in the Core Data Programming Guide section "Concurrency With Core Data" :
https://developer.apple.com/library/mac/#documentation/cocoa/conceptual/CoreData/Articles/cdConcurrency.html

This seems to be a major oversight as the new queue confinement pattern offers significant benefits over thread confinement, but developers are likely to overlook queue confinement due to it's absence from the programming guide. 

Documentation should include common use cases, correct and incorrect use, as well as information about safe and unsafe operations.

Steps to Reproduce:

Expected Results:

Actual Results:

Regression:

Notes:

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!