您尚未登录账户
您的企业账号申请正在审核中
AWS 转变策略：公共 GitHub 文档即将停用
在接下来的几天内，AWS将开始逐步淘汰目前在GitHub上提供的AWS文档。在审查了该项目的结果并考虑到手动同步内部文档所需的工作量后，这家云服务提供商最近决定淘汰大部分公共代码库。
为了提高开放性和协作性，AWS的开源文档从未获得开发者的广泛支持，有些开发者抱怨自己提出的请求经常被忽视。AWS副总裁兼主要宣传员杰夫·巴尔（Jeff Barr）解释了这一变化的原因："大部分AWS文档的主要来源是我们内部系统中的文档，需要我们手动同步到GitHub代码库上。尽管我们的文档团队做出了最大的努力，但保持公共代码库与我们内部代码库的同步一直是非常困难和耗时的，需要进行多个手动步骤和一些平行编辑，这增加了很大的开销，实际上浪费了宝贵的时间，本可以从直接提高文档质量的方式中得到解决"。
并非所有的代码库都将被淘汰，包含代码样例、示例应用程序、CloudFormation模板、配置文件以及其他补充资源的代码库将作为主要资源继续保留。
AWS五年前最初在GitHub上提供了文档，并邀请有兴趣的开发者通过合并请求形式贡献变化和改进。当时，Barr写道："你可以修复错误、改进代码样例或者提交新的样例。你也可以查看提交历史，以了解新功能和服务发布的更多信息，并跟踪文档的改进。"
虽然一些开发者会想进行差异比较以追踪变化和强调问题报告的选项，但其他人则欣赏AWS最终承认了这种较差的情况。在Reddit上一个流行的帖子中，一些用户质疑解决方案应该是将GitHub作为主要代码库，而其他人则建议改进自动化。The Duckbill Group的首席云经济学家Corey Quinn评论道："AWS能够认识到某些事情并不像他们计划的那样顺畅，并改变方向，同时也能够不将文档错误作为客户自行解决的责任，这一点值得称赞。"
云计算专家、AWS无服务器英雄本·凯霍(Ben Kehoe)在推特上发表了以下推文："我认为这是一个正确的决定。我很想拥有适当开放和协作的AWS文档，但在没有这些文档的情况下，承认它比我们的现状要好。"
AWS并不是唯一一个提供开源文档的云服务提供商，微软Azure文档也可以在GitHub上获得。
来源：https://www.infoq.com/news/2023/06/aws-documentation-github/
