Retiring the AWS Documentation on GitHub


Voiced by Polly

About 5 years in the past I introduced that AWS Documentation is Now Open Supply and on GitHub. After a chronic interval of experimentation we’ll archive many of the repos beginning the week of June fifth, and can commit all of our assets to straight enhancing the AWS documentation and web site.

The first supply for many of the AWS documentation is on inner methods that we needed to manually sync with the GitHub repos. Regardless of the perfect efforts of our documentation group, protecting the general public repos in sync with our inner ones has confirmed to be very troublesome and time consuming, with a number of handbook steps and a few parallel modifying. With 262 separate repos and hundreds of characteristic launches yearly, the overhead was very excessive and truly consumed valuable time that would have been put to make use of in ways in which extra straight improved the standard of the documentation.

Our intent was to extend worth to our prospects via openness and collaboration, however we realized via buyer suggestions that this wasn’t essentially the case. After fastidiously contemplating many choices we determined to retire the repos and to speculate all of our assets in making the content material higher.

Repos containing code samples, pattern apps, CloudFormation templates, configuration recordsdata, and different supplementary assets will stay as-is since these repos are major sources and get a excessive degree of engagement.

To assist us enhance the documentation, we’re additionally focusing extra assets in your suggestions:

We watch the thumbs-up and thumbs-down metrics on a weekly foundation, and use the metrics as top-level tips that could areas of the documentation that could possibly be improved. The incoming suggestions creates tickets which can be routed on to the particular person or the group that’s answerable for the web page. I strongly encourage you to make frequent use of each suggestions mechanisms.

— Jeff;



Related Articles

LEAVE A REPLY

Please enter your comment!
Please enter your name here

Latest Articles