亚马逊AWS官方博客
AWS 文档现推出开放源版并在 GitHub 上开放
今年初,我们将 AWS 开发工具包开发人员指南以 GitHub 转贴的方式发布 (所有都可在 awsdocs 组织中找到),并邀请感兴趣的人以 Pull 请求的方式贡献修改和改进。
今天我们为该组织再次增加了 138 个开发人员指南和用户指南,同样期待收到您的请求。您可以修复漏洞,完善代码样本 (或提交新代码样本),增加详细信息,以及重新编写句段以提高准确性或明确性。此外,您还可以查看提交历史以进一步了解新功能和服务发布,跟踪文档的改进。
如何贡献
在开始使用前,请阅读 Amazon 开放源行为守则以及所感兴趣的 AWS 服务的贡献指南文档 (通常名称为 CONTRIBUTING.md
)。 然后创建一个 GitHub 账户 (如果您还没有)。
如果发现有需要修改或完善之处,请访问该文档的 HTML 版,单击页面顶端的 Edit on GitHub (在 GitHub 上编辑) 按钮:
这将允许您以源格式 (一般为 Markdown 或 reStructuredText) 编辑文档。源代码用于生成文档的 HTML、PDF 和 Kindle 版本。
登录 GitHub 后,单击铅笔标志:
这将会创建一个“分支” — 也就是该文件的一个独立副本,您可以对其进行独立编辑。
然后进行编辑。一般而言,作为开放源项目的新贡献者,您应当通过小的高质量编辑积累经验和声誉。在此文档中,我将把“dozens of services” 修改为“over one hundred services”:
然后我总结我的修改并单击 Propose file change (建议文件修改):
我会检查差异来验证我的修改,然后单击 Create pull request (创建 Pull 请求):
然后我会检查详细信息并再次单击 Create pull request (创建 Pull 请求):
Pull 请求 (简称 PR) 将会被转交给 Elastic Beanstalk 文档团队,他们会决定是否接受、拒绝或联系我了解更多信息。该团队会尽力在 48 小时内处理 Pr,每当 PR 的状态发生变化时都将通过 GitHub 通知我。
与大多数开放源项目一样,经常提交重点明确、大小适中的 Pull 请求,要比偶尔提交包含数十项编辑的超大请求更受欢迎。
如果我对转贴的长期修订历史感兴趣,我可以 Watch (关注) 它和/或 Star (加星):
如果我 Watch (关注) 某个转贴,我将在该服务指南有新的发布、发行或 Pull 请求时收到电子邮件通知。
立即建立分支
本次发布为您提供了又一个帮助我们完善 AWS 的途径。请告诉我您的意见!
— Jeff;