2014 年 5 月 26 日
关注 @orta2013 年 3 月,我上传了 初始提交 以用于 CocoaDocs。此操作触发了我 一年的过山车。我非常激动地宣布,CocoaDocs 的第二次迭代现已运行,并且 解析 新的 Docset。
主要功能列表
因此,令我惊讶的是,CocoaDocs 在网络流量方面险胜 CocoaPods 指南。这是我(orta)对 OSS 社区做出重大贡献的最初出发点,虽然技术上很棒,但我一直为设计受限而烦恼。这让我烦恼不已,以至于我 为 CocoaPods 的整个内容启动了重新设计流程。现在,我摆脱了这个负担。
随着 CocoaDocs 的大部分坚实基础发挥作用,我可以坐下来辩论影响更广泛的含义。CocoaDocs 的核心是最佳实践,添加文档 是库生命周期中的重要部分。我相信测试是另一部分,因为使用 Travis CI 入门非常容易,而且它对开源是免费的,因此,在我看来,将该元数据包含在库中是不费吹灰之力的。
开始
我还觉得 CocoaDocs 对不想阅读源代码的开发者来说是一个黑匣子,而这基本上是每个人。因此,我冒昧地创建了 CocoaDocs 开发者文档。这是一个你可以预览自定义样式并获得我在 Twitter 上回答的大量问题的答案的地方。
即将推出
这不是 CocoaDocs 2 的正式版本,我正在等待 2014 年 WWDC 之后,以了解世界是否再次发生了变化,从而开始在超过 15k 个库上运行 CocoaDocs。在此期间,新库将获得新样式,旧库将保留旧样式。CocoaDocs 上仍然有一些 未解决的问题,但还有时间,我们现在已经稳定在 95%。
如果没有 appledoc、Danger、CocoaPods 开发团队 和所有贡献了库的人的帮助,CocoaDocs 将无法存在。