首页
学习
活动
专区
工具
TVP
发布
精选内容/技术社群/优惠产品,尽在小程序
立即前往

苹果的官方文档很糟糕

Apple

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

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

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

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

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

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

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

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

没有文档可查....去他XX,搞清楚!

  • 发表于:
  • 原文链接https://kuaibao.qq.com/s/20201111A0G7JK00?refer=cp_1026
  • 腾讯「腾讯云开发者社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 cloudcommunity@tencent.com 删除。

扫码

添加站长 进交流群

领取专属 10元无门槛券

私享最新 技术干货

扫码加入开发者社群
领券