What's even worse is they used to have great documentation, then for some nonsense reason archived it and replaced it with this wannabe JavaDocs crap with vague function explanations that leave more questions open than they resolve.
They now tell people to watch WWDC videos as if those relatively short videos contained the same amount of information a proper API documentation does.
honestly i don't see this as Apple-specific but more of a sign of the times. i've seen a few libraries and vendor platforms we use at work with the same style of documentation (really lack thereof).
Microsoft's documentation quality very noticeably fell of a cliff about a decade ago. Now most of their public APIs and SDKs have hundreds of thousands of "documentation" pages that are just the name of the function with spaces added between the words. There might also be a listing of the parameters, which helpfully tells you that "string param1" is called "param1" and takes a string as the data type.
Yeah, the extreme basics seems to be the trend. We've actually had a lot of trouble due to this exact problem with one particular vendor now. Even repeated requests to improve their documentation are completely ignored or laughed off. it's too bad I don't have the purchasing power otherwise I'd suggest we should find a different vendor.
They now tell people to watch WWDC videos as if those relatively short videos contained the same amount of information a proper API documentation does.