I have been trying to make iOS/macOS apps for years, but god, every time I have a go at it, Apple's documentation regime is still hot garbage. Eons ago I gave up Windows development because of Microsoft's inconsistent and uncertain APIs, but MS had great documentation. Apple is the opposite.
The "best" way to get the "latest" details on Apple's APIs is to suffer through mind-numbingly vapid WWDC videos with their reverse uncanny valley presenters (where humans pretend to be robots) and keep your full attention on them to catch a fleeting glimpse of a single method or property that does what you were looking for. Even 1.5x/2x speed is torture. I tried to get AIs to sift through the transcripts of their videos, and may Skynet forgive me for this cruelty.
Then when you go try to use that API, oops it's been changed in the current beta and there's no further documentation on it except auto-generated headers.
They also removed bookmarks from Xcode's built-in documentation browser years ago, and it doesn't retain a memory of previously open tabs, and often seems to be behind the docs on their websites.
I wish they would just provide open-source sample apps of each type (document-based, single-window etc.) for each of their platforms that fully use the latest APIs. At least that would be easier to ask AIs on, since that is what they seem to be going for now anyway.
Ever notice Claude struggling to write Swift code? It might not be their fault!
Apple Developer docs are locked behind JavaScript, making them invisible to most LLMs. If they try to fetch it, all they see is This page requires JavaScript. Please turn on JavaScript in your browser and refresh the page to view its content.
This service translates Apple Developer documentation pages into AI-friendly Markdown.
https://sosumi.ai/
I pretty much had the same experience recently when I had to deal with their Screen Time APIs. Had to go through the wwdc videos because the documentation was lack lustre.
Something you might find useful: https://askwwdc.com/