AWS把技术文件当程式码开源放上GitHub欢迎使用及维护

AWS要把自家的技术文件开源，张开手欢迎外界对官方文件提出修改请求，现在开发者可以到GitHub上浏览并修改AWS释出的这些文件，以程式码版本控制的概念共同维护技术文件。

AWS在3月13日开源138份开发者与使用者手册到GitHub，AWS表示，欢迎开发者提交修改请求，无论是修正错误、改进或是增加新的程式码範例都行，另外，还可以添加详细资讯并重新调整句子和段落以提高描述精準度。

这已经不是AWS第一次这么做，在今年初AWS就将SDK开发者手册放到GitHub上，并且邀请有兴趣的团体贡献文件内容。

贡献者要参与修改AWS技术文件，必须先拥有一个GitHub帐号。当发现官方技术文件需要更改的部分，就能拜访GitHub网页版本的文件，并在页面上点击Edit on GitHub按键，如此便能让贡献者编辑文件的原始本文，而这个原始本文是用来输出为HTML、PDF以及Kindle版本的文件。

与GitHub程式码版本控制的概念相同，贡献者可以先Fork一份複本独立编辑，当编辑完成后，并在Propose file change的栏位总结改变的内容，经过确认修改部分无误后，点击Create pull request（PR），确认后送出请求。

这个修改的内容会视贡献者修改的服务主题，分配给负责该服务的团队，例如贡献者修改了Elastic Beanstalk相关文件，则会由 Elastic Beanstalk团队负责审核PR，他们会决定接受PR、拒绝PR，或是与贡献者进行讨论，负责的团队必须在48小时内作出回应，而贡献者也会接收到PR的最新处理状态。

AWS也顺带提醒，当贡献者新加入一个开源专案时，应该先以较小以及高水準的内容编辑，获取经验以及建立名声，并且每次的PR应该长度适中，切勿在一次PR更改庞大的资料，增加审核难度。