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.

AWS documentation is now open source and on GitHub

243 pointsby singhshashiabout 7 years ago

13 comments

jjeaffabout 7 years ago
Brilliant. Let unpaid volunteers fix and update the documentation for your proprietary systems so you don&#x27;t have to pay someone to do it.<p>Can someone explain to me why people will inevitably put in countless hours of free labor for Amazon here?
评论 #16581843 未加载
评论 #16581537 未加载
评论 #16581591 未加载
评论 #16581759 未加载
评论 #16582366 未加载
评论 #16581573 未加载
评论 #16582064 未加载
评论 #16582848 未加载
评论 #16582081 未加载
评论 #16583307 未加载
评论 #16582172 未加载
评论 #16583320 未加载
评论 #16581712 未加载
评论 #16582641 未加载
评论 #16581437 未加载
评论 #16581607 未加载
评论 #16583491 未加载
评论 #16581528 未加载
评论 #16582202 未加载
评论 #16582606 未加载
评论 #16582394 未加载
评论 #16583605 未加载
评论 #16583354 未加载
评论 #16581708 未加载
评论 #16585266 未加载
评论 #16582095 未加载
评论 #16582104 未加载
Terrettaabout 7 years ago
Azure says come in in, the water’s fine.<p><a href="https:&#x2F;&#x2F;github.com&#x2F;MicrosoftDocs&#x2F;azure-docs" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;MicrosoftDocs&#x2F;azure-docs</a><p><a href="https:&#x2F;&#x2F;docs.microsoft.com&#x2F;en-us&#x2F;contribute&#x2F;" rel="nofollow">https:&#x2F;&#x2F;docs.microsoft.com&#x2F;en-us&#x2F;contribute&#x2F;</a>
评论 #16583422 未加载
评论 #16581600 未加载
pvsnpabout 7 years ago
I for one, welcome this change.. assuming I can grep for what I&#x27;m looking for in the repos. Or maybe Dash will integrate the docs so I don&#x27;t have to browse around on metered LTE networks.
Rapzidabout 7 years ago
This is.. Odd. AWS is notoriously a black box. Their services aren&#x27;t open source and on github; who would have the insider view necessary to work on the docs outside of their own employees? Is this easier than having an edit suggestion feature? Will PR&#x27;s cause clashes with their technical writers?
评论 #16582333 未加载
lloyddeabout 7 years ago
It looks like at least some of the guides are licensed Creative Commons BY-SA.<p>For code samples do they do something similar to Mozilla?<p>Mozilla MDN:<p>“Code samples and snippets<p>Code samples added on or after August 20, 2010 are in the public domain (CC0). No licensing notice is necessary, but if you need one, you can use: &quot;Any copyright is dedicated to the Public Domain. <a href="http:&#x2F;&#x2F;creativecommons.org&#x2F;publicdomain&#x2F;zero&#x2F;1.0&#x2F;&quot;.”" rel="nofollow">http:&#x2F;&#x2F;creativecommons.org&#x2F;publicdomain&#x2F;zero&#x2F;1.0&#x2F;&quot;.”</a>
jawnsabout 7 years ago
On a lark, I just forked the repo for the AWS CLI user guide and added some commits that introduced subtle and not-so-subtle errors. Let&#x27;s hope my fork never shows up in search results. Otherwise, people are going to be making curl requests to r&#x2F;tacobell to download the AWS CLI Bundled Installer.<p>If this collaborative-documentation initiative were launched as an Amazon-hosted wiki, editors or mods could shut me down. But since it&#x27;s open source and under a Creative Commons license, Amazon has essentially no control over how much I vandalize the content.<p>Fortunately for AWS, I&#x27;m not really interested in vandalizing the content or misleading people. But the fact that someone can create a knock-off site riddled with errors, and Amazon can&#x27;t claim copyright infringement if the site plays by the Creative Commons rules, is concerning, isn&#x27;t it?<p>Edit: I know, I know. It&#x27;s already possible to make unauthorized copy-pasta sites. But at least Amazon would have the ability to threaten the site&#x27;s owner or hosting provider with copyright infringement claims. That option disappears when you release your official documentation under a Creative Commons license.
评论 #16581699 未加载
评论 #16582098 未加载
shady-ladyabout 7 years ago
I would reject that PR.<p>Something like that change should have a message explaining why that change is proposed.<p>Unfortunate that the blogpost itself can&#x27;t be forked :p
评论 #16583008 未加载
d_burfootabout 7 years ago
Gah, choke, barf.<p>Crowd-sourcing is <i>not</i> the right way to document a big complex software suite.<p>The right way is to use special software to compile or extract the documentation from the underlying source code. The documentation generator should be conceptually similar to a Jupyter Notebook or a Mathematica Computable Document.<p>Furthermore, the documentation generator should run actual code that throws an error if there&#x27;s a mistake. For example, in this document:<p><a href="https:&#x2F;&#x2F;github.com&#x2F;awsdocs&#x2F;aws-cli-user-guide&#x2F;blob&#x2F;master&#x2F;doc-source&#x2F;cli-dynamodb.md" rel="nofollow">https:&#x2F;&#x2F;github.com&#x2F;awsdocs&#x2F;aws-cli-user-guide&#x2F;blob&#x2F;master&#x2F;do...</a><p>The CLI operations should be lifted from some other file, and that other file should get run as a test by a CI tool, so that when there&#x27;s a change to the CLI, it&#x27;s automatically flagged for correction.
评论 #16584396 未加载
ivan_ahabout 7 years ago
It&#x27;s interesting that they mix markdown and restructured text. ReST is clearly the superior formatting language, but markdown is so much easier to pick up and use.
评论 #16582292 未加载
voidhorseabout 7 years ago
Uh oh, looks like my tech writing career is under threat (so of course I&#x27;m posting with a bit of bias here). A wise move on amazon&#x27;s part though, offload your work on to users who will improve the docs for a couple of reasons:<p>1. They can add their contributions to their resumes. 2. They use the software and more than likely reference the docs, and so are already stakeholders that desire the content to be correct and so will happily fix it given the chance so that they can save themselves headaches in the future. 3. The general concept of &#x27;open source&#x27; is very enticing and is almost always has a positive connotation, so very few people will see that this is a clever way to cut costs and net free labor and not really the virtuous public gesture of transparency and good will a lot will perceive it to be.<p>This would be different if, like actual open source <i>software</i> others could pull the thing and conceivably make a better version of it and <i>compete</i>, but since this is necessarily bound to a product that&#x27;s not going anywhere outside the organization, it&#x27;s de facto always going to be free labor for amazon and never going to promote potential forking out of modified versions of the project, further securing the companies foothold in the market as well--after all, if you no longer have to pay folks for all the extra bits like documentation, support, and maintenance of internal libraries, you can have nothing but a horde of devs working on the user-facing product, and ensure all of your money goes toward nothing other than squashing the competition. Sure you could argue it&#x27;s still technically <i>possible</i> for someone&#x27;s fork to gain bigger traction than the official amazon repo, but cmon now, the project is so massive and is so bound to the company that such a scenario is highly unlikely. On the plus side, open sourcing is a boon for archivists were the main content to ever disappear (unlikely).<p>I realize this sounds a little bleak, and I&#x27;m sure amazon also has good intentions with this move, but I can&#x27;t help but see the potential for future markets where a lot of free labor is snagged under the banner of &#x27;open source&#x27; simply because people are shortsightedly seeking resume boosts and not realizing that contributing labor freely will more than likely hurt the job market in the long run.<p>Not saying you shouldn&#x27;t contribute to open source, nor is the idea of open source a bad one, but I think the lines get a bit blurred when it comes to open source projects owned by private (massive, in this case) corporations who are then gaining from the work of outsiders without needing to compensate them. Sure, helping out looks good on your resume, just as unpaid internships do--but at some point we need to take a look at these practices that can be, whether intentionally or not, ways of sidestepping the proper dispensation of wages and compensation for labor.<p>They may still need to pay somebody to green light merges, but that&#x27;s a lot less costly, I imagine, than paying a team of writing professionals.
评论 #16588396 未加载
评论 #16581830 未加载
hallziabout 7 years ago
Cool! How does aws translate their docs?
crb002about 7 years ago
Finally. Been asking for this for years.
foreignerabout 7 years ago
Now if only they would open-source the AWS Console...