{"id":25308,"date":"2019-05-20T17:09:26","date_gmt":"2019-05-20T21:09:26","guid":{"rendered":"https:\/\/mjtsai.com\/blog\/?p=25308"},"modified":"2024-06-15T14:07:13","modified_gmt":"2024-06-15T18:07:13","slug":"the-state-of-apples-developer-documentation","status":"publish","type":"post","link":"https:\/\/mjtsai.com\/blog\/2019\/05\/20\/the-state-of-apples-developer-documentation\/","title":{"rendered":"The State of Apple’s Developer Documentation"},"content":{"rendered":"

Scott Anguish<\/a>:<\/p>\n

\n

It appears that most of the old iOS conceptual documents have been moved to the documentation archive and are now unsupported.<\/p>\n

Is there really no iOS Text Programming concepts? Or are the indexes just that bad?<\/p>\n

That is more than a decade of work by dozens, just being abandoned.<\/p>\n

I can’t even grasp how that’s any solution.<\/p>\n

If this is the case every single iOS developer should be screaming from the rafters. It’s by far the stupidest move I’ve seen in a decade.<\/p>\n

You can’t write apps without authoritative docs.<\/p>\n

It’s bad enough the reference doc has reached the point it has.<\/p>\n<\/blockquote>\n\n

It’s surprising how much of the documentation is marked as legacy, archived, not up-to-date, or was never written in the first place. At first I thought this was because of some sort of internal transition, but it’s been going on for years now and does not seem to be getting any better.<\/p>\n\n

Steve Tibbett<\/a>:<\/p>\n

As far as I can tell, this is the only documentation on IAP receipt validation. This is part of a current system that’s making Apple billions of dollars. There are errors in it, and it’s “no longer being updated”.<\/p><\/blockquote>\n\n

Martin Pilkington<\/a>:<\/p>\n

\n

Fun fact: when I was looking up docs for Help Books for my Appreciating AppKit post, one of the few Mac features already supported in Marzipan, it took ages to find as they’re only available in the documentation archive<\/p>\n<\/blockquote>\n\n

Matt Stevens<\/a>:<\/p>\n

If you’re struggling to find an Apple developer document you know exists, it’s not just you. http:\/\/developer.apple.com’s robots.txt disallows \/library\/archive\/, where all of the old docs now live. Apple’s own “Search Documentation Archive”…doesn’t search the archive.<\/p><\/blockquote>\n\n

Previously:<\/p>\n