I object to that. Some of Apple's most serious features are missing vital documentation details!
Re:Apple ExtensionKit
by sebastien_b on Monday October 31, 2022 @03:38PM
(#33411598)
Exactly. All this lack of vital info, from a company that offers APIs for developers to use (consume), is disgraceful. Especially when they claim they have over 1000 engineers, and keep showing off their $6B+ campus at every opportunity in their keynotes. They clearly have the resources to hire people to do proper documentation, but refuse to (no doubt because "Courage").
>Still lacks proper documentation (like, vital details still missing). So obviously not a serious feature yet.
Those two things are completely orthogonal tho... an API/tool/service can even be used to build billion dollar businesses and not have proper documentation...
As a total noob studying Swift and SwiftUI documentation I was wondering about this. But I couldn't believe this huge company would neglect their developer community like that. But as I delved deeper I found everything is beautiful on a surface level and beyond that suddenly there are no standards.
This fact has been reported multiple times before
That seems like a really good reason not to post it again as a toplevel comment.
https://hn.algolia.com/?dateRange=all&page=0&prefix=true&que...
Maybe there is a market for complete, comprehensive documentation by a 3rd party? Something similar to "definitive" programming books of the past, but web-based / searchable and maybe importable into IDEs.
Re:Apple ExtensionKit
by sebastien_b on Monday October 31, 2022 @04:15PM
(#33412297)
I believe there already are plenty (objc.io, Swift by Sundell, Hacking w/ Swift, many more), where they're both technical and tutorial style info.
But I still feel that, as paying developers (membership fees, and giving out 15-30% of sales to Apple), we should get all the basic info needed without relying on third parties to get it.
This fact has been reported multiple times before[1][2][3], and it's frustrating that a company that claims having over 1000 engineers, and touts its $6B campus at every opportunity in every one of its keynotes has, evidently, not enough resources for proper documentation.
[1]https://news.ycombinator.com/item?id=33411242 [2]https://news.ycombinator.com/item?id=33410300 [3]https://news.ycombinator.com/item?id=33410329