4 ms·

Still lacks proper documentation (like, vital details still missing). So obviously not a serious feature yet. This fact has been reported multiple times before

Still lacks proper documentation (like, vital details still missing). So obviously not a serious feature yet. 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 https://news.ycombinator.com/item?id=33411242 [2]https://news.ycombinator.com/item?id=33410300 https://news.ycombinator.com/item?id=33410300 [3]https://news.ycombinator.com/item?id=33410329 https://news.ycombinator.com/item?id=33410329

afandian 4y ago
I object to that. Some of Apple's most serious features are missing vital documentation details!
- sebastien_b 4y ago
  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").
coldtea 4y ago
>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...
deleted 4y ago
[deleted]
smodo 4y ago
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.
pvg 4y ago
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&query=author%3Adang%20repetition%20curiosity%20indignation&sort=byDate&type=comment https://hn.algolia.com/?dateRange=all&page=0&prefix=true&que...
towawy 4y ago
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.
- sebastien_b 4y ago
  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.

afandian 4y ago

I object to that. Some of Apple's most serious features are missing vital documentation details!

sebastien_b 4y ago
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").

coldtea 4y ago

>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...

deleted 4y ago

[deleted]

smodo 4y ago

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.

pvg 4y ago

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&query=author%3Adang%20repetition%20curiosity%20indignation&sort=byDate&type=comment https://hn.algolia.com/?dateRange=all&page=0&prefix=true&que...

towawy 4y ago

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.

sebastien_b 4y ago
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.