Live data from Hacker News

AWS documentation is now open source and on GitHub

aws.amazon.com

31–40 of 102 posts

Re: AWS documentation is now open source and on GitHub

#31
post #3

Brilliant. Let unpaid volunteers fix and update the documentation for your proprietary systems so you don't have to pay someone to do it. Can someone explain to me why people will inevitably put in countless hours of free labor for Amazon here?

On the one hand, I agree with you. On the other; GOD I hope it works because their documentation is loathsome sometimes.

Re: AWS documentation is now open source and on GitHub

#33
post #3

Brilliant. Let unpaid volunteers fix and update the documentation for your proprietary systems so you don't have to pay someone to do it. Can someone explain to me why people will inevitably put in countless hours of free labor for Amazon here?

Just think of all the uncompensated value you've given Y Combinator every time you've left a quality comment on their forum.

Then again, Y Combinator makes no direct money off HN. AWS’ docs, if they are quality directly impacts their profit because more people can use their services more easily.

Re: AWS documentation is now open source and on GitHub

#34
post #3

Brilliant. Let unpaid volunteers fix and update the documentation for your proprietary systems so you don't have to pay someone to do it. Can someone explain to me why people will inevitably put in countless hours of free labor for Amazon here?

I don't want to make the same mistake when doing something. It's more of a service to other people than to Amazon (People probably aren't going to choose a different service based on documentation). It also helps to have different viewpoints from levels of experience to help with wording and such.

Re: AWS documentation is now open source and on GitHub

#35
post #30
post #27

Earlier quoted context omitted.

That documentation devolved over time into a tire fire of bad and dangerous advice.

which is still better than no advice at all. It's good to know there are bad practices out there, and the doc team should update the doc and show how to avoid bad practice.

I disagree.

I will happily take docs, such as rust's docs or NaCl's docs, which don't ever mention the possible of md5summing a password, to docs where there are hundreds of comments recommending exactly that terrible practice.

There are a practically infinite number of ways to do things wrong, and very few ways to do things right. Documenting the right way by exhaustively demonstrating the wrong ways is a fool's errand.

But more to the point, I will happily take no docs at all to docs that are more wrong than right.

Re: AWS documentation is now open source and on GitHub

#36
post #3

Brilliant. Let unpaid volunteers fix and update the documentation for your proprietary systems so you don't have to pay someone to do it. Can someone explain to me why people will inevitably put in countless hours of free labor for Amazon here?

On the other side, what if Amazon gets sued based on something written by a volunteer contributor?

Re: AWS documentation is now open source and on GitHub

#37
post #15

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's hope my fork never shows up in search results. Otherwise, people are going to be making curl requests to r/tacobell to download the AWS CLI Bundled Installer. If this collaborative-documentation initiative were launched as an Amazon-hosted wiki, editors or mods could shut me down.…

> Edit: I know, I know. It's already possible to make unauthorized copy-pasta sites. But at least Amazon would have the ability to threaten the site's owner or hosting provider with copyright infringement claims. That option disappears when you release your official documentation under a Creative Commons license.

You misunderstand trademark law.

Trademark law is meant to prevent confusion, and would kick in here.

Nothing is different with respect to creating a confusing fork; before they wouldn't claim copyright infringement before either, but trademark infringement.

Re: AWS documentation is now open source and on GitHub

#38
This is.. Odd. AWS is notoriously a black box. Their services aren'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's cause clashes with their technical writers?

Re: AWS documentation is now open source and on GitHub

#39
post #3

Brilliant. Let unpaid volunteers fix and update the documentation for your proprietary systems so you don't have to pay someone to do it. Can someone explain to me why people will inevitably put in countless hours of free labor for Amazon here?

Why do people put in countless hours of free labor for Jimmy Wales?

Re: AWS documentation is now open source and on GitHub

#40
It looks like at least some of the guides are licensed Creative Commons BY-SA.

For code samples do they do something similar to Mozilla?

Mozilla MDN:

“Code samples and snippets

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: "Any copyright is dedicated to the Public Domain. http://creativecommons.org/publicdomain/zero/1.0/".”

Post reply on HN