TE
TechEcho
Home24h TopNewestBestAskShowJobs
GitHubTwitter
Home

TechEcho

A tech news platform built with Next.js, providing global tech news and discussions.

GitHubTwitter

Home

HomeNewestBestAskShowJobs

Resources

HackerNews APIOriginal HackerNewsNext.js

© 2025 TechEcho. All rights reserved.

Retiring the AWS Documentation on GitHub

5 pointsby jeffbarrabout 2 years ago

2 comments

myroon5about 2 years ago
(copying from <a href="https:&#x2F;&#x2F;old.reddit.com&#x2F;r&#x2F;aws&#x2F;comments&#x2F;13ki1o9&#x2F;retiring_the_aws_documentation_on_github&#x2F;" rel="nofollow">https:&#x2F;&#x2F;old.reddit.com&#x2F;r&#x2F;aws&#x2F;comments&#x2F;13ki1o9&#x2F;retiring_the_a...</a>)<p>Ecstatic this is finally being publicly addressed after half a decade<p>The actual <i>awsdocs</i> source code was never really open. The internal source code <i>wasn&#x27;t even the same language</i> and the Github markdown files were just build artifacts generated from the internal source code using something like XSLT. Some services didn&#x27;t upload anything at all for years<p>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&#x27; tech writers because PRs edited build artifacts instead of the actual source code used to generate them<p>---<p>Was never a tech writer myself, but always empathized with them knowing how much AWS leaders rush launches out before they&#x27;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-treatsabout 2 years ago
It&#x27;s weird that there&#x27;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.