AWS Transformation Strategy: Public GitHub Documentation to be Discontinued

2023-06-05

In the coming days, AWS will gradually phase out the AWS documentation currently available on GitHub. After reviewing the project and considering the amount of manual synchronization required for internal documentation, the cloud service provider recently decided to eliminate most of the public code repositories. To enhance openness and collaboration, AWS's open-source documentation has never received widespread support from developers, with some developers complaining that their requests are often ignored. Jeff Barr, Vice President and Chief Evangelist of AWS, explained the reason for this change: "The main source of most AWS documentation is the documentation in our internal system, which needs to be manually synchronized to the GitHub code repository. Despite the best efforts of our documentation team, keeping the public code repository in sync with our internal code repository has always been very difficult and time-consuming, requiring multiple manual steps and parallel editing, which adds significant overhead and actually wastes valuable time that could be spent on directly improving the quality of the documentation." Not all code repositories will be phased out, as code repositories containing code samples, example applications, CloudFormation templates, configuration files, and other supplementary resources will continue to be maintained as primary resources. Five years ago, AWS initially provided documentation on GitHub and invited interested developers to contribute changes and improvements through pull requests. At that time, Barr wrote, "You can fix errors, improve code samples, or submit new ones. You can also view commit history to learn more about new features and service releases and track improvements to the documentation." While some developers may want the option to compare differences to track changes and highlight issues, others appreciate that AWS has finally acknowledged this subpar situation. In a popular Reddit post, some users questioned whether the solution should be to make GitHub the primary code repository, while others suggested improving automation. Corey Quinn, Chief Cloud Economist at The Duckbill Group, commented, "AWS is able to recognize that things aren't going as smoothly as they planned and change direction, while also not making documentation errors the responsibility of customers to resolve. This is commendable." Cloud computing expert and AWS Serverless Hero Ben Kehoe tweeted, "I think this is the right decision. I'd love to have AWS documentation that is properly open and collaborative, but admitting that it's better without that documentation than with our current state." AWS is not the only cloud service provider offering open-source documentation; Microsoft Azure documentation is also available on GitHub. Source: https://www.infoq.com/news/2023/06/aws-documentation-github/

RECENT AI NEWS

RECENT AI TOOLS