苹果的文档很糟糕

Apple

在过去的一两年里，我逐渐意识到，让我更难完成工作的头号问题可能就是文档了。或者更准确地说，苹果为其平台提供的文档完全匮乏。

作为开发者，苹果为我们提供了一系列工具--API，让我们可以在iOS、iPadOS、macOS和tvOS上开发应用。在很多情况下，如何使用这些API是相当直接的。你可以使用螺丝刀的方法只有那么几种，同样，在很多情况下，使用API的方法也明显只有一种。

但随着需要实现的需求变得越来越复杂和花哨，API往往也需要跟着变得更花哨和更复杂。然后，突然间你抬头一看，你用的不只是螺丝刀和锤子，还有电动工具和复杂的锯子，一切都比以前费劲多了。

对于真正的工具，你会期望拥有一本用户手册，解释如何使用你刚刚购买的工具。对于API来说，也存在一个相似的类比，因为大多数平台厂商都会提供文档。这基本上就是该API的 "用户手册"了。

苹果的文档，多年来一直都很糟糕。在过去的几年里，它已经从糟糕→可怕→卑劣→变得尴尬了。很多时候，我去研究如何做一些新的事情，使用一个我不熟悉的API，得到的结果却是： No overview available.

这是苹果公司说 "去你XX，自己想办法 "的方式。

没有一个可用的概述是如此糟糕，以至于一个流行的苹果资源(它本身可能不应该存在)用它作为一个单一服务网站存在，来强调苹果的文档是多么地不实用。

进步的作用也无济于事。正如我的朋友所指出的那样，随着旧的API被废弃，新的API往往不会更新添加的属性，导致新的API没有文档可查。

没有文档可查....去他XX，搞清楚！