Hacker News Reader

I have seen the same incomplete and inconsistent documentation for many Google and Microsoft projects including Kubernetes and many cloud based services. And it is not only about their REST APIs but for their SDKs for programming languages/frameworks not limited to Javascript/Node.

View on HN

Why would it be different for Google or Microsoft projects?

I think sidlls was talking about industries where lives are at stake, like aviation , where things move slowely and follow a strict QA process. There you have formally verified systems and the like, but you also have to make tradeoffs like working with a limited subset of C because that is formally verifiable.

I completely agree on that part. I wanted to highlight that at least the bigcos should provide consistent and comprehensive documentation for their popular libraries/APIs.

Reply on news.ycombinator.com