Apple’s Developer Documentation is historically pretty terrible. So I’d be curious to see if they stepped it up for the agent instructions for the new API’s.
Apple's current docs suck, and they have, for a long time (SwiftUI was so bad, that someone came up with this[0], and it was a lifesaver).
But I'm old enough to remember Inside Macintosh[1], and that was a thing of beauty.
Apple used to take technical documentation very seriously. Many of their technical writers had better tech chops, than the engineers making the stuff they wrote about.
I really wish they still did, instead of focusing so much on trying to make it simple and obvious like in SwiftUI. Objective-C was a pinnacle of computing, and ever since Swift they've been devolving into the pursuit of oversimplifying and abstracting away the details such that they don't even feel necessary to teach anymore, even though as a new developer, I WANT TO KNOW THEM.
Austin_Conlon · · focus · HN ↗
TheJoeMan · · focus · HN ↗
ChrisMarshallNY · · focus · HN ↗
Depends on how far back you go.
Apple's current docs suck, and they have, for a long time (SwiftUI was so bad, that someone came up with this[0], and it was a lifesaver).
But I'm old enough to remember Inside Macintosh[1], and that was a thing of beauty.
Apple used to take technical documentation very seriously. Many of their technical writers had better tech chops, than the engineers making the stuff they wrote about.
[0] <a href="https://swiftui-lab.com" rel="nofollow">https://swiftui-lab.com
[1] <a href="https://vintageapple.org/inside_o/" rel="nofollow">https://vintageapple.org/inside_o/
LoganDark · · focus · HN ↗
matwood · · focus · HN ↗
Historically it was very good. Back when I was writing Mac and iOS apps in objective-c, Apple's docs were some of the best.