No high-level documentation for Swift/NSError bridging

Originator:zach
Number:rdar://36546392 Date Originated:No high-level documentation for Swift/NSError bridging
Status:Open Resolved:false
Product:Other Product Version:N/A
Classification:Suggestion Reproducible:N/A
 
(Screener: Please redirect to Dev Pubs)

Documentation > Foundation > Errors and Exceptions <https://developer.apple.com/documentation/foundation/errors_and_exceptions> should provide motivation or explanation of what customizing of error bridging means to a Swift application developer. Alternatively, an article in that section of the documentation or a chapter in the "Using Swift with Cocoa and Objective-C" book would be nice. <https://github.com/apple/swift-evolution/blob/master/proposals/0112-nserror-bridging.md> remains the most comprehensive reference for this feature, which is undesirable. I have now at least 3 times encountered a teammate trying to build this feature on their own because they didn't know the standard one existed. This lack of awareness in the community reduces the quality of error-handling by third-party applications on Apple platforms.

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!