David Livesay wrote:
Not only is the built-in documentation in Xcode undated
It is dated. You just aren't looking in the right place.
The main Xcode documentation page lists all the documentation sorted by date. Furthermore, each page in the documentation, such as the one on
targets, ends with a "Last Updated" date.
I mean, it's like they have gone out of their way and bent over backwards to mislead people! This isn't just sloppy. It's deceptive.
No. You're wrong. It is just an oversight. Documentation is a pain to update in the best of times and there has been an awful lot going on with MacOS X and Xcode since 2006.
Why on earth would Apple software engineers want to "deceive" you? Come on! That is patently ridiculous. It is a mistake and oversight, sure. But it is a mistake that every single software engineer has done at some point on every single project - myself included. Eventually we get caught up. If we have bug fixes and new capabilities ready, why withhold them from users until you get all the outdated documentation purged. Release the new code, especially the new code that is required for new operating systems and/or new hardware, and clean up the old documentation when you get around to it.
I wonder how many would-be Windows developer converts have simply given up and gone back to Windows because the documentation for Xcode is so pathetic.
Lots of them, hopefully.