Retiring the AWS Documentation on GitHub

https://aws.amazon.com/blogs/aws/retiring-the-aws-documentation-on-github/

by jeffbarr • 3 years ago

5 2 3 years ago

aws.amazon.com

myroon5• 3 years ago

(copying from https://old.reddit.com/r/aws/comments/13ki1o9/retiring_the_a...)

Ecstatic this is finally being publicly addressed after half a decade

The actual awsdocs source code was never really open. The internal source code wasn't even the same language and the Github markdown files were just build artifacts generated from the internal source code using something like XSLT. Some services didn't upload anything at all for years

Public issues will be sorely missed if repos are archived, but soliciting pull requests in the initial announcement never made complete sense because PRs usually created more work for AWS' tech writers because PRs edited build artifacts instead of the actual source code used to generate them

---

Was never a tech writer myself, but always empathized with them knowing how much AWS leaders rush launches out before they're ready and refuse to make necessary investments post-launch while individual contributors slog through maintaining hacks like this for half a decade before leaders publicly acknowledge the extent of internal issues

scrum-treats• 3 years ago

It's weird that there's no way to export to markdown, and sync internal docs with Github in an automated fashion. At any rate, glad the code samples and templates will remain.

Retiring the AWS Documentation on GitHub

Related Stories