开发者吐槽苹果：连开发文档都不重视何谈用户体验？
编者按：本文来自微信公众号“新智元”（ID：AI_era），来源：HackerNews，编辑：鹏飞，36氪经授权发布。
开发者不满苹果开发文档缺失发文吐槽。平台的开发文档对开发者来说非常重要，是指导其针对平台进行开发的最重要工具。随着苹果不断增加AI、VR等新技术方面的内容，开发文档的价值就尤为重要。开发者称：如果苹果想让开发者爱上这个平台，请做好开发文档！
苹果旗下iOS平台拥有超过2千万的开发者，每年营收超过1千亿美元。然而近年来，苹果越来越激进的开发主张，也引发了越来越多开发者的的不满。
一位资深开发者ChrisKrycho因为在过去的几个月内，不得不再次学习Swift和SwiftUI，甚至要重新熟悉iOS和macOSapi。整个过程让他的愤怒值不断累积。
而压倒骆驼的最后一根稻草，是他发现这个生态系统中，大量缺失的关键技术文档资源。
发布API的时候，请顺便完善开发文档好吗！
开发文档对开发者来说，就好比是通往平台宝库的指引。如果一个平台的开发文档不够完善，开发者将会面对很多困难。而Chris认为，这一届的Apple开发文档是他见过最差的。
Swift本身不错，写的很好，维护的也棒，但大多数SwiftUI都是零文档！甚至连一条关于给定类型或修饰符作用的解释都没有！
SwiftPackageManager的文档还凑合吧，但是你也基本不可能从官方文档里了解它能干什么不能干什么。Chris表示，这些基础知识还都是从StackOverflow了解到的。
开源世界中，文档非常重要。在Ember生态系统中除非有文档记录，否则代码无法交付；Rust也是如此。而苹果的api开发人员生活在一个不同的世界，尤其是因为他们面临着与硬件产品交付相关的发布问题。
但无论如何，在发布API的时候，请顺便完善开发文档好吗！
根据Chris对Apple的处理方法的了解，他认为苹果对开发文档的忽视，不在于工程师，甚至不在于他们的文档团队，而是整个苹果工程师部门的问题，需要上升到整个工程师组织！
苹果很早开始，积累了大批经验最丰富的开发者，可他们为什么偏偏就不注重开发文档呢？
Chris呼吁苹果公司：开发者是平台的命脉，请认真一点对待好吗！一定要服务好开发者，不要让他们被开发文档这种基础问题挡在门外！
当然，文章发出后这篇文章发出来以后，在HackerNews上引发了热烈讨论，大家纷纷表示：不是你一个人这么觉得！
网友热议：苹果的开发文章真的鸡肋！
Shank：当我开始研究项目时，我是从API文档入手的，结果很多问题如使用辅助功能API以受支持的方式读取菜单栏中每个菜单中的所有项目，该怎么办？支持吗？我应该遵循一组最佳做法吗等，并不能在官方文章里找到答案。
bob1029：我也是。我尝试在苹果文档找相关iOS13API的问题，让我很觉悟。5分钟后，我还是回到了谷歌和stackoverflow的怀抱。
chooseaname：苹果公司有足够的狂热支持者，他们有时可能会因为糟糕的文档而失去开发人员。苹果不在乎，他们那样傲慢自大。另外，还有哪些其他平台？Android？iOS开发人员中相当一部分也已经是Android开发人员。你看，这只是充耳不闻。苹果根本不会听你的。
苹果之路耗时更多，且总是选择最难走那条！
另一位开发者DominicBurford表示，自己从事开发工作近20年，用过各种平台，唯苹果最奇葩！以下是他的吐槽原文：
似乎没有遵循任何明确定义的标准或最佳实践；苹果的习惯是故意忽略其他开发平台上定义明确和理解的模式和实践，并以“他们的方式”进行操作；可以说，“Apple之路”通常要耗时得多，复杂且容易出错。苹果的座右铭似乎是跟简约之道反着来。
当给出两种或多种解决问题的方法时，始终选择最差的那个；从供应配置文件和证书到asset目录，“Apple方式”从来都不是简单、直接或直观的。
遇到的几乎每个问题或错误都与该应用程序的iOS版本有关（在Telerik平台和XamarinForms上）。
这就是我认为Apple方式很糟糕的原因。仅出于此目的而做其他事情并不是创新。有很好的理由使某些想法成为开发领域内的最佳实践。这是因为它们有效。不仅是能用，还需要被业内人士很好地理解和接受。他们已经接受了测试，并获得了成功。
作为专业的软件开发人员，工程师和架构师，这些年来，我可以诚实地说，我从未遇到过像Apple提供的那样糟糕的开发平台。
如果您真的认为Apple是出色的开发产品，那么我建议您看看其他人如何构建他们的开发工具。例如，微软和谷歌构建了出色的开发工具，它们在流程和工作流程中采用了行业最佳实践和标准。
不幸的是，尽管苹果仍然是移动应用领域的佼佼者，但像我这样的开发人员将只需要忍受“苹果方式”做事。我认为苹果公司最好浏览一下行业中的其他公司并从中获得一些启发。除非这样做，否则他们将继续挫败那些发现“AppleWay”繁琐，耗时且效率低下的开发人员。
封面图来自：pexels
