5 ms·
The most frustrating thing is when the docs have that "this document is no longer maintained. Please see /documentation/whatever for the latest version" but whe
by povertyworld 7y ago
The most frustrating thing is when the docs have that "this document is no longer maintained. Please see /documentation/whatever for the latest version" but when you go the link it ends up just linked back to the place you came from. I guess that means the unmaintained stuff is still current? I don't know though because it's still all Objective-C, so I have no idea what the current best practice is supposed to look like. For a trillion dollar company it's kind of annoying that they can't hire somebody to do the docs. For MacOS dev there are basically no third party resources either. The last book is from Swift 3. It's better than nothing, but not much.
- plorkyeran 7y agoThe "this document is no longer maintained" notice is on everything that's no longer being updated regardless of whether or not there's actually a replacement. Sometimes it's actually still up to date, sometimes it's out of date and there's something else you should be looking at, and sometimes it's just plain out of date and the only newer source of information is a WWDC session from two years ago.
- jrochkind1 7y agoWhat made Apple think it was okay to abandon their documentation, just decide not to update it without a replacement?
- saagarjha 7y agoInsufficient pushback from developers?
- deleted 7y ago[deleted]
- bsaul 7y agodue to the fact that they simply have no choice but to use apple dev tools. Or at least that was true on iOS until recently. That, plus the fact that Apple having a monopoly on the store relieve them from any kind of pressure, because no matter how the dev feels about it, they’re going to give 30% commission to apple.
- jonhendry18 7y agoGive them a break, they're a small, resource-constrained company.
- jasonmp85 7y agoI came across the EXACT same thing. I just wanted to do something as simple as “give me an actual core dump instead of a crash report in Console.app” Found some obsolete docs and they linked back to themselves. It’s absolutely unacceptable. Man pages are better, except Apple’s often don’t cover their weird, uncommon behaviors.
- mthoms 7y agoFYI, there is a Swift 5 book available now.