Live data from Hacker News

AWS documentation is now open source and on GitHub

aws.amazon.com

71–80 of 102 posts

Re: AWS documentation is now open source and on GitHub

#71
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?

Keep in mind that this also makes it easier for any Amazon employee to improve documentation. That's 1,000s of developers who are equally confused about AWS APIs and are incentivized to make it better.

Re: AWS documentation is now open source and on GitHub

#72
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?

That’s one way of looking at it.

Another is to consider this as Amazon giving the users a standard, simple way of fixing the documentation issues they inevitably run into.

Re: AWS documentation is now open source and on GitHub

#73
post #58
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?

> Can someone explain to me why people will inevitably put in countless hours of free labor for Amazon here? Most people is good a heart and they want to help, even when it's bad for themselves or even illegal. "Under the federal Fair Labor Standards Act (“FLSA”) and many state and local wage and hour laws, the use of volunteers and interns is strictly regulated." https://www.forbes.com/sites/richardtuschman/2012/08/…

While that's an interesting point, it's not as simple as it being 'illegal' either.

I've told vendors of documentation bugs - and they've even listened. I wasn't paid by the vendor, I was paid by my employer. Who has a business relationship with the vendor. I sort of doubt this is illegal.

Re: AWS documentation is now open source and on GitHub

#75
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?

> Can someone explain to me why people will inevitably put in countless hours of free labor for Amazon here?

I wish I knew. Reminds me of Google Map Maker, aka "Work for Google producing proprietary mapping data that even you can't get back for free".

Re: AWS documentation is now open source and on GitHub

#76
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?

But how is that different to answering questions on SO?

The payoff in this case is probably getting your name into the official docs and leveraging that reputation as an AWS guru into pay/promotions later

Re: AWS documentation is now open source and on GitHub

#77

Earlier quoted context omitted.

YC does two things that aren't directly making money but are definitely helping their portfolio companies: 1) Special ad positions with front-page placement (currently #22 is "Willing (YC S15) Is Hiring a UI / UX Designer" https://willing.com/designer , a privileged post that can't be voted or commented on) 2) The moderators can and sometimes do intervene by removing certain comments that are critical of YC companies…

Nothing is free. If you aren't paying, you're the product.

Personally, I'm surprised that's a controversial statement.

Re: AWS documentation is now open source and on GitHub

#78

Earlier quoted context omitted.

Nothing is free. If you aren't paying, you're the product.

Personally, I'm surprised that's a controversial statement.

Its not on this forum. Its so common as to be a cliche.

Re: AWS documentation is now open source and on GitHub

#79
post #74
post #7

Azure says come in in, the water’s fine. https://github.com/MicrosoftDocs/azure-docs https://docs.microsoft.com/en-us/contribute/

I know it's been a while, but I still cant get over the azure outage that lasted almost a full day in 2012.

Thats a very long time ago in cloud computing years.

Re: AWS documentation is now open source and on GitHub

#80

Gah, choke, barf. Crowd-sourcing is not the right way to document a big complex software suite. 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. Furthermore, the documentation generator should run actual code that throws an error if the…

While for docs which are very close to code, you're right, good documentation has a lot of things at much higher level than code, and a lot of times teaching people how to do things unrelated to the actual implementation, ie "how to expand a linux file system after you increased an EBS volume". Your comments are a bit reductionist.
Post reply on HN