news.volyx.in

Apple Developer Documentation Is Missing (v4.chriskrycho.com)

830 points by chriskrycho · 2544 days ago · 389 comments on HN

Article summary

The article discusses the lack of documentation for Apple's developer ecosystem, particularly for SwiftUI and other APIs. The author, who has experience with JavaScript and other frameworks, finds the state of Apple's documentation to be unacceptable. The author argues that good documentation is essential for developers to work efficiently and effectively with a platform. Apple's lack of documentation is seen as a failure of the company's engineering organization.

Main themes

  • Apple documentation
  • Developer ecosystem
  • API documentation
  • Software development
  • Platform support

What commenters say

  • Apple's documentation is severely lacking and this is a major issue for developers, making it hard for them to work with the platform.
  • The company's focus on releasing new features and products has led to a neglect of documentation, which is essential for a good developer experience.
  • Other companies, such as Microsoft, have better documentation and this is due to their focus on enterprise business and support.
  • Some developers have had positive experiences with Apple's support team, but this is not a substitute for good documentation.
  • The lack of documentation is not just a problem for new developers, but also for experienced ones who need to learn new APIs and technologies.
  • Apple's wealth and resources mean that there is no excuse for the poor state of their documentation, and they should invest in hiring teams to write and maintain it.
  • Good documentation is hard work and requires a full-time effort, but it is essential for a platform to be successful and attract developers.