Posts updated today:
WWDC 2019 Preview
https://mjtsai.com/blog/2019/05/21/wwdc-2019-preview#wwdc-2019-preview-update-2019-05-28 …
The State of Apple’s Developer Documentation
https://mjtsai.com/blog/2019/05/20/the-state-of-apples-developer-documentation#the-state-of-apples-developer-documentation-update-2019-05-28 …
#mjtsaiblog
From comments on your post today “Apple's docs turned downhill fast when they switched to automatically generating docs instead of using human-written, structured, and curated materials.” Except that’s not what happened. It’s all human-written, structured, and curated”
-
-
The reference docs aren’t collecting HeaderDoc comments or equivalent?
- 2 more replies
New conversation -
-
-
rrrrrrrrrrrriiiiiigggggghhhhhhtttttt https://developer.apple.com/documentation/kernel/1462446-mach_absolute_time …
-
I’m speaking from 12 years of working in that specific department at Apple. But sure, what do I know. That the description is missing and those other details are missing is because the management doesn’t care.
-
Sir if you're trying to tell me that the page linked above (and reproduced in its entirety here) was "human-written", and not automatically generated, you will need something much more than an Appeal to Authority. I hope this sounds reasonable.pic.twitter.com/g94tAQ6dvE
-
I’m telling you the documentation isn’t pulled from headers. It’s all xml documents. Written by humans. Or In this case not written, since nobody bothered to write a description or anything.
-
Here’s a fun one: the descriptions of the two by-property merge policies are backwards: https://developer.apple.com/documentation/coredata/nsmergepolicy/1690609-mergebypropertystoretrumpmergepo?language=objc …
-
That’s just a plain old mistake. Not purposeful negligence
I’d say file a bug...
End of conversation
New conversation -
Loading seems to be taking a while.
Twitter may be over capacity or experiencing a momentary hiccup. Try again or visit Twitter Status for more information.