AWS 决定停止在 GitHub 上维护公开文档
在接下来的几天里,AWS 将开始停止维护目前在 GitHub 上提供的 AWS 文档。经过对该项目的评估,考虑到手动保持内部文档同步的开销,AWS 决定停止维护其大多数公开仓库。
背景与原因
AWS 最初在五年前将文档开源到 GitHub,目的是提高开放性和协作性。然而,这一举措并未在 AWS 社区中获得广泛欢迎,开发者抱怨他们的拉取请求(Pull Requests)经常被忽略。AWS 副总裁兼首席布道师 Jeff Barr 解释道,AWS 文档的主要来源是内部系统,需要手动与 GitHub 仓库同步,这一过程非常耗时且繁琐,消耗了大量本可以用于直接提升文档质量的宝贵时间。
保留的仓库
并非所有仓库都会被停止维护。包含代码示例、示例应用程序、CloudFormation 模板、配置文件和其他补充资源的仓库将继续作为主要来源保留。
社区反应
一些开发者将怀念通过差异比较(diff)来跟踪文档变化的能力,并指出报告问题的选项减少了。其他人则赞赏 AWS 最终承认了这一不尽如人意的现状。在 Reddit 的热门讨论中,一些用户质疑是否应该将 GitHub 作为主要仓库,而另一些人则建议更好的自动化解决方案。
专家观点
The Duckbill Group 的首席云经济学家 Corey Quinn 对 AWS 的决定表示赞赏,认为 AWS 不仅认识到了问题,还采取了行动,而不是将文档错误的责任推给用户。AWS Serverless Hero 和云专家 Ben Kehoe 也认为这是正确的决定,尽管他更希望看到真正开放和协作的 AWS 文档,但在当前情况下,承认问题比维持现状要好。
其他云提供商的实践
AWS 并非唯一提供开源文档的云提供商,Microsoft Azure 的文档也可以在 GitHub 上找到。
总结
AWS 决定停止在 GitHub 上维护公开文档,主要是由于手动同步内部和外部文档的高开销和低效率。尽管这一决定可能会让一些开发者感到不便,但 AWS 的透明态度和及时调整的做法得到了部分专家和社区成员的认可。
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用。你还可以使用@来通知其他用户。